セット登録
メニュー
更新履歴
概要
POSTメソッドにより診療情報のセット登録等を行います。
日レセ Ver.4.8.0[第25回パッチ適用] 以降
リクエストおよびレスポンスデータはxml2形式となります。
テスト方法
- 参考提供されている sample_medicalset_v2.rb 内の変数HOST等を接続環境に合わせます。
- sample_medicalset_v2.rb 内のセットコード等を指定します。
- ruby sample_medicalset_v2.rb により接続。
リクエスト(POSTリクエスト)サンプル
POST : /orca21/medicalsetv2
Request_Number:
01: 新規登録
02: 削除
03: 最終終了日更新
04: セット内容取得
Content-Type: application/xml
application/xml の場合の文字コードは UTF-8 とします。
<data>
<medicalsetreq type="record">
<Request_Number type="string">01</Request_Number>
<Base_Date type="string"/>
<Set_Code type="string">PAI004</Set_Code>
<Set_Code_Name type="string">ＡＰＩセット３</Set_Code_Name>
<Start_Date type="string">2013-04-01</Start_Date>
<Ende_Date type="string">9999-12-31</Ende_Date>
<InOut type="string"/>
<!-- ========================================================== -->
<!-- 診療データ -->
<!-- ========================================================== -->
<Medical_Information type="record">
<Medical_Info type="array">
<!-- ========================================================== -->
<Medical_Info_child type="record">
<Medical_Class type="string">210</Medical_Class>
<Medical_Class_Name type="string">内服</Medical_Class_Name>
<Medical_Class_Number type="string">3</Medical_Class_Number>
<Medication_Info type="array">
<Medication_Info_child type="record">
<Medication_Code type="string">612320391</Medication_Code>
<Medication_Name type="string">イサロン顆粒２５％</Medication_Name>
<Medication_Number type="string">0.5</Medication_Number>
</Medication_Info_child>
<Medication_Info_child type="record">
<Medication_Code type="string">611170791</Medication_Code>
<Medication_Name type="string">イミドール糖衣錠</Medication_Name>
<Medication_Number type="string">2</Medication_Number>
</Medication_Info_child>
<Medication_Info_child type="record">
<Medication_Code type="string">611120080</Medication_Code>
<Medication_Name type="string">ユーロジン１ｍｇ錠</Medication_Name>
<Medication_Number type="string">1.6</Medication_Number>
</Medication_Info_child>
<Medication_Info_child type="record">
<Medication_Code type="string">001000106</Medication_Code>
<Medication_Name type="string">１日１回朝食後に</Medication_Name>
<Medication_Number type="string"/>
</Medication_Info_child>
</Medication_Info>
</Medical_Info_child>
<!-- ========================================================== -->
<Medical_Info_child type="record">
<Medical_Class type="string">600</Medical_Class>
<Medical_Class_Name type="string">検査</Medical_Class_Name>
<Medical_Class_Number type="string">1</Medical_Class_Number>
<Medication_Info type="array">
<Medication_Info_child type="record">
<Medication_Code type="string">160023410</Medication_Code>
<Medication_Name type="string">ＨＤＬ−コレステロール</Medication_Name>
<Medication_Number type="string"/>
</Medication_Info_child>
<Medication_Info_child type="record">
<Medication_Code type="string">160019310</Medication_Code>
<Medication_Name type="string">ＵＡ</Medication_Name>
<Medication_Number type="string"/>
</Medication_Info_child>
<Medication_Info_child type="record">
<Medication_Code type="string">160020910</Medication_Code>
<Medication_Name type="string">ＴＧ</Medication_Name>
<Medication_Number type="string"> </Medication_Number>
</Medication_Info_child>
<Medication_Info_child type="record">
<Medication_Code type="string">160019210</Medication_Code>
<Medication_Name type="string">クレアチニン</Medication_Name>
<Medication_Number type="string"> </Medication_Number>
</Medication_Info_child>
</Medication_Info>
</Medical_Info_child>
<!-- ========================================================== -->
<!-- ========================================================== -->
<Medical_Info_child type="record">
<Medical_Class type="string">960</Medical_Class>
<Medical_Class_Name type="string">保険外（消費税あり）</Medical_Class_Name>
<Medical_Class_Number type="string">1</Medical_Class_Number>
<Medication_Info type="array">
<Medication_Info_child type="record">
<Medication_Code type="string">096000002</Medication_Code>
<Medication_Name type="string">自費その２</Medication_Name>
<Medication_Number type="string"/>
<Medication_Money type="string">12945</Medication_Money>
</Medication_Info_child>
<Medication_Info_child type="record">
<Medication_Code type="string">095930000</Medication_Code>
<Medication_Name type="string">自賠責器材Ａ</Medication_Name>
<Medication_Number type="string"/>
<Medication_Money type="string">10</Medication_Money>
</Medication_Info_child>
</Medication_Info>
</Medical_Info_child>
<!-- ========================================================== -->
</Medical_Info>
</Medical_Information>
</medicalsetreq>
</data>
処理概要
診療情報のセットの登録、削除、有効期間の変更、登録内容の参照を行います。
処理詳細
- リクエスト番号の妥当性チェック
新規登録処理(リクエスト番号＝01)
リクエスト内容で入力セット・入力コードを新規に追加登録します。
約束セット（SXXXXX）の登録はできません。
削除処理(リクエスト番号＝02)
セットコード・開始日・終了日の一致する入力セットを削除します。
開始日＝00000000、終了日＝99999999の時は、すべての履歴を削除します。
最終終了日更新(リクエスト番号＝03)
セットコード・開始日の一致する入力セットが最終履歴の時、終了日を変更します。
最終履歴以外は変更できません。
セット内容取得(リクエスト番号＝04)
セットコード・開始日・終了日の期間内の入力セット内容を返却します。
開始日＝00000000、終了日＝99999999の時は、システム日付（基準日）で有効な履歴を返却します。
システム日付で有効な履歴がない時は、最終履歴を返却します。
※基準日（システム日付）時点で点数マスタの検索を行います。
開始日＞基準日の時は、開始日＝基準日
終了日＜基準日の時は、終了日＝基準日
とします。
リクエスト一覧
| 番号 | 項目名 | 内容 | 例 | 備考 |
|---|---|---|---|---|
| 1 | Request_Number | リクエスト番号 01：新規登録 02：削除 03：最終終了日更新 04：セット内容取得 | 01 | 必須 |
| 2 | Base_Date | 基準日 | 未設定時はシステム日付を設定 | |
| 3 | Set_Code | セットコード | PAI004 | 必須 ※１ |
| 4 | Set_Code_Name | セット名称 | APIセット３ | 必須(新規登録) |
| 5 | Start_Date | 開始日付 | 2013-04-01 | 未設定時は00000000を設定 |
| 6 | Ende_Date | 終了日付 | 9999-12-31 | 未設定時は99999999を設定 |
| 7 | InOut | 入外区分 （I：入院分） | I | |
| 8 | Medical_Information | 診療行為情報 | ※２ | |
| 8-1 | Medical_Info | 診療行為剤内容（繰り返し ４０） | ||
| 8-1-1 | Medical_Class | 診療種別区分 | 960 | 必須 |
| 8-1-2 | Medical_Class_Name | 診療種別区分名称 | 保険外（消費税あり） | |
| 8-1-3 | Medical_Class_Number | 回数 | 1 | 未設定時は1、0はエラー |
| 8-1-4 | Medication_Info | 診療剤明細（繰り返し ４０） | ||
| 8-1-4-1 | Medication_Code | 診療行為コード | 096000002 | 約束セット(SXXXXX)は使用できない(エラーになります) |
| 8-1-4-2 | Medication_Name | 名称 | 自費その２ | ※３ |
| 8-1-4-3 | Medication_Number | 数量 | | ※４ |
| 8-1-4-4 | Medication_Money | 自費金額 | 12945 | 金額ゼロで登録してある自費コードの金額(消費税込) |
| 8-1-4-5 | Medication_Input_Info | コメント埋め込み数値（繰り返し ５） | 84XXXXXXX,0084XXXXX,001XXXXXX(カラム位置あり)のみ | |
| 8-1-4-5-1 | Medication_Input_Code | コメント埋め込み数値 | １番目から順に数値を編集 | |
| 8-1-4-6 | Medication_Continue | 継続コメント指示区分 （1：継続のコメントコードである） | 1 | |
| 8-1-4-7 | Medication_Internal_Kinds | 内服種類数指示区分 （1：内服種類数を１とする） | 1 |
※１：１桁目はP、
２，３桁目は英数値、
４，５，６桁目は数値
新規以外は１桁目がS（約束セット）も可能となります。
※２：リクエスト番号=01（新規）のみ設定します。
※３：名称を入力するコメントコード（81XXXXXXX,83XXXXXXX,0083XXXXX,0085〜）は全内容（点数マスタの名称＋入力内容）
※４：システム管理の数量ゼロ入力が「１ 入力エラーとする」の時、薬剤・器材の数量、診療行為のきざみ値数量のゼロを可能とします。
それ以外の数量ゼロはエラーとなります。
レスポンス一覧
| 番号 | 項目名 | 内容 | 例 | 備考 |
|---|---|---|---|---|
| 1 | Information_Date | 実施日 | 2015-12-08 | |
| 2 | Information_Time | 実施時間 | 15:15:43 | |
| 3 | Api_Result | 結果コード（ゼロ以外エラー） | E21 | ※１ |
| 4 | Api_Result_Message | エラーメッセージ | セット内容に誤りがあります。 | |
| 5 | Reskey | Medical Info | ||
| 6 | Base_Date | 基準日 | 2015-12-08 | |
| 7 | Set_Code | セットコード | PAI004 | 送信内容 |
| 8 | Set_Code_Name | セット名称 | APIセット３ | |
| 9 | Start_Date | 開始日付 | 2013-04-01 | |
| 10 | Ende_Date | 終了日付 | 9999-12-31 | |
| 11 | Medical_Information | 診療行為登録内容 | ※２ | |
| 11-1 | Medical_Info | 診療行為剤内容（繰り返し ４０） | ||
| 11-1-1 | Medical_Class | 診療種別区分 | 960 | |
| 11-1-2 | Medical_Class_Name | 診療種別区分名称 | 保険外（消費税あり） | |
| 11-1-3 | Medical_Class_Number | 回数 | 1 | |
| 11-1-4 | Medication_Info | 診療剤明細（繰り返し ４０） | ||
| 11-1-4-1 | Medication_Code | 診療行為コード | 096000002 | |
| 11-1-4-2 | Medication_Name | 名称 | ※３ | |
| 11-1-4-3 | Medication_Number | 数量 | 1 | |
| 11-1-4-4 | Medication_Money | 自費金額 | 12945 | |
| 11-1-4-5 | Medication_Input_Info | コメント埋め込み数値（繰り返し ５） | ||
| 11-1-4-5-1 | Medication_Input_Code | コメント埋め込み数値 | ||
| 11-1-4-6 | Medication_Continue | 継続コメント指示区分 | ||
| 11-1-4-7 | Medication_Internal_Kinds | 内服種類数指示区分 | ||
| 12 | Medical_Message_Information | メッセージ内容 | ||
| 12-1 | Medical_Message_Info | エラーメッセージ内容（繰り返し ５０） | ||
| 12-1-1 | Medical_Result | エラーコード | 0001 | ※５ |
| 12-1-2 | Medical_Result_Message1 | エラーメッセージ１ | 該当する点数マスターが存在しません | ※５ |
| 12-1-3 | Medical_Result_Message2 | エラーメッセージ２ | ※５ | |
| 12-1-4 | Medical_Position | エラー剤位置 | 6 | 診療行為内容（Medical_Info）の位置 |
| 12-1-5 | Medical_Item_Position | エラー行位置 | 1 | 診療剤明細（Medication_Info）の位置 |
| 12-1-6 | Medical_Result_Code | エラー診療コード | 096000002 | |
| 12-2 | Medical_Warning_Info | ワーニングメッセージ内容（繰り返し ５０） | ||
| 12-2-1 | Medical_Warning | ワーニングコード | ※５ | |
| 12-2-2 | Medical_Warning_Message1 | ワーニングメッセージ１ | ※５ | |
| 12-2-3 | Medical_Warning_Message2 | ワーニングメッセージ２ | ※５ | |
| 12-2-4 | Medical_Warning_Position | ワーニング剤位置 | 診療行為内容（Medical_Info）の位置 | |
| 12-2-5 | Medical_Warning_Item_Position | ワーニング行位置 | 診療剤明細（Medication_Info）の位置 | |
| 12-2-6 | Medical_Warning_Code | ワーニング診療コード |
※１：正常終了：【000】、ワーニングあり：【W00】、エラーあり：【EXX】
※２：リクエスト番号＝04（セット内容取得）でセットコードが約束セット（SXXXXX）の時、診療種別区分を追加記載します。
※３：名称を入力するコメントコードで内容を送信された場合は、送信内容。
コメント埋め込み数値があれば反映した名称を編集
それ以外は、点数マスタの名称（用法コード（001XXXXX）は【】をつける）
※４：画面展開時の剤単位で返却します。
剤に検査が複数存在し展開で剤分離となった場合、展開後の剤毎に返却するが、セット登録では診療種別区分の登録はない。
※５：診療行為内容のエラー・ワーニングメッセージを編集します。
エラー・ワーニングコードはセット登録画面と同様とします。
但し、【APXX】は、API独自のコード・メッセージになります。
エラーメッセージ１、エラーメッセージ２、ワーニングメッセージ１、ワーニングメッセージ２は画面の（KERR2）の上下のメッセージとなります。
エラーメッセージ、ワーニングメッセージが１つの時は、１に編集します。
