• 文字サイズ変更
  • S
  • M
  • L
株式会社アルメックス

Sma-pa マイナタッチ
ユーザー向け会員ページ

ALMEXトップ
  • No : 69989
  • 公開日時 : 2023/09/08 13:50
  • 印刷

保険証、公費医療券OCR機能の出力ファイル仕様について

このFAQはマイナタッチのOCR機能とレセコン・電子カルテ等の院内上位システムと連携するプログラム作成に携わる方向けのご説明です。
※新ファイル命名規則(XmlFlleNameType=1)に沿ってのご説明になります。
 
・公費医療券読取機能の出力ファイルの仕様を知りたい
・健康保険証(被保険者証)読取機能の出力ファイルの仕様を知りたい
・xmlファイルの仕様について
・券面画像の仕様について
 
合わせてご参照ください。
カテゴリー : 

回答

◆XML出力仕様
①マイナンバーカード+公費
②保険証単体
③保険証+公費
参考:業務コード表
 
 
◆保険証のみ利用時、保険証+公費利用時のXML出力の場合
・資格確認結果のXML仕様に準拠した設計としています。
・保険証XMLと公費XMLのOCR結果は1つのファイルにセットされます。
・1枚目の券面として保険証を利用した場合には、MessageBody部とResultList部に同じ保険証OCR結果がセットされます。
 (システム連携に際し、ご利用しやすい方の出力結果をご参照いただくことを想定しています)
 
 
■共通
  メッセージヘッダ部    MessageHeader
  処理実行日時    ProcessExecutionTime
   →公費医療券の読取を行い結果ファイルが生成された日時
  医療機関コード    MedicalInstitutionCode
   →保険医療機関について定められた10桁のコード
    都道府県番号(2桁)+点数表番号(1桁)+医療機関(薬局)コード(7桁)
  照会区分    ReferenceClassification
   →患者の提示した券情報の区分
    被保険者証の種類※コード値は、保険証単体:7、保険証+公費:8、マイナンバーカード+公費:9
  処理結果区分    SegmentOfResult
   →OCR読取処理結果
    ※処理結果区分が正常終了を示す場合のみ、メッセージボディ部を返却します(「2.処理中」は設定されません)。
    ※一項目でも読み取れていれば読取結果XML、券面画像JPGを出力します。
    ※全く読取ができなかった場合はXML、JPGファイル共に出力されません。
  エラーコード    ErrorCode
   →処理結果区分が正常終了以外を示す場合、エラー内容に準ずるコードを設定します。
  エラーメッセージ    ErrorMessage
   →処理結果区分が正常終了以外を示す場合、エラー内容を設定します。
  文字コード識別    CharacterCodeIdentifier
   →結果ファイル出力用の文字コードを指定する識別コード
    ※管理コンソールで設定された文字コードを出力します。
 
 
■保険証OCR結果(保険証の氏名、性別、住所などは資格確認結果に含まれるため、読取対象外)
 ①メッセージボディ     MessageBody
  資格確認照会用情報     QualificationConfirmSearchInfo
  保険者番号     InsurerNumber
   →OCR結果:被保険者証券面記載の保険者番号
    保険証OCRにて8桁固定とし、国保(6桁)の場合は先頭にSP(半角スペース)をセットして8桁にします
  被保険者証記号     InsuredCardSymbol
   →OCR結果:被保険者証券面記載の被保険者証記号
  被保険者証番号     InsuredIdentificationNumber
   →OCR結果:被保険者証券面記載の被保険者証番号
  被保険者証枝番     InsuredBranchNumber
   →OCR結果:被保険者証券面記載の被保険者証枝番
  生年月日     Birthdate
   →OCR結果:被保険者証券面の生年月日
  限度額適用認定証提供同意フラグ     LimitApplicationCertificateRelatedConsFlg
   →限度額適用認定証の情報について、患者の提供同意を示す区分
    コード値は、顔認証リーダー操作時の情報をセットします。
  照会番号    ReferenceNumber
   →医療機関にて登録する任意の番号
 
 ②資格確認結果リスト    ResultList
  資格確認結果    ResultOfQualificationConfirmation
  被保険者証区分    InsuredCardClassification
   →専用フラグ『I1』(あい、いち)をセット
  保険者番号    InsurerNumber
   →OCR結果:被保険者証券面記載の保険者番号 
    保険証OCRにて8桁固定とし、国保(6桁)の場合は先頭にSP(半角スペース)をセットして8桁にします
  被保険者証記号    InsuredCardSymbol
   →OCR結果:被保険者証券面記載の被保険者証記号
  被保険者証番号    InsuredIdentificationNumber
   →OCR結果:被保険者証券面記載の被保険者証番号
  被保険者証枝番    InsuredBranchNumber
   →OCR結果:被保険者証券面記載の被保険者証枝番
  生年月日     Birthdate
   →OCR結果:被保険者証券面の生年月日
  限度額適用認定証提供同意フラグ     LimitApplicationCertificateRelatedConsFlg
   →限度額適用認定証の情報について、患者の提供同意を示す区分
    コード値は、顔認証リーダー操作時の情報をセットします。
  照会番号    ReferenceNumber
   →医療機関にて登録する任意の番号
 
※ResultList部には、主保険読取として「I1」(あい、いち)フラグを追加セットします。
 
 
■公費医療券OCR結果(公費の氏名、住所、生年月日などは資格確認結果に含まれるため、読取対象外)
 ※1枚目がマイナンバーカードの場合、MessageBody部にオンライン資格確認により取得した値がセットされます。
 ※1枚目が保険証の場合、保険証OCR結果がMessageBody部、ResultList部(上記①②)にそれぞれセットされます。
 ※1枚目が保険証の場合、ResultList部には公費医療券OCR結果、保険証OCR結果の順でセットされます。
 
  資格確認結果リスト    ResultList
  資格確認結果    ResultOfQualificationConfirmation
  被保険者証区分    InsuredCardClassification
   →被保険者証の種類 P1:子育て支援、P2:ひとり親支援、P3:心身障害者支援
  保険者番号⇒公費証書:負担者番号    InsurerNumber
   →OCR結果:公費証書券面記載の負担者番号 100桁(可変長)
    連結前の桁数:8桁(固定長)
  被保険者証記号    InsuredCardSymbol
   →OCR結果:公費証書券面記載の記号
  被保険者証番号⇒公費証書:受給者番号    InsuredIdentificationNumber
   →OCR結果:公費証書券面記載の受給者番号または番号
  被保険者証枝番    InsuredBranchNumber
   →OCR結果:公費証書券面記載の枝番
  生年月日    Birthdate
   →OCR結果:公費証書券面記載の生年月日
  被保険者証交付年月日    InsuredCertificateIssuanceDate
   →OCR結果:公費証書が交付された日
  被保険者証有効開始年月日    InsuredCardValidDate
   →OCR結果:公費証書が有効である最初の日 50桁(可変長)
    連結前の桁数:8桁(固定長)
  被保険者証有効終了年月日    InsuredCardExpirationDate
   →OCR結果:公費証書が有効である最後の日 50桁(可変長)
    連結前の桁数:8桁(固定長)
  被保険者証一部負担金割合    InsuredPartialContributionRatio
   →OCR結果:公費証書 一部負担割合  50桁(可変長)(例)1割負担の時は、"010"と設定します
    連結前の桁数:3桁(固定長)
  被保険者証一部負担金限度額    InsuredPartialContributionLimit
   →OCR結果:公費証書公費用追加項目 50桁(可変長)
    連結前の桁数:6桁(可変長)
  照会番号    ReferenceNumber
   →医療機関にて登録する任意の番号
 
 
※P1、P2、P3は高額療養費制度の後の公費の読取対象券面を選択する画面(下絵)にて、患者様が選択した券面の値がセットされます。
 (マイナタッチでは券面の判断は行っておらず、読取結果、選択結果を出力します)
 
 
 
 
★参考:ファイル名について(ALMocrNNres_生年月日_[DeviceID]_yyyyMMddHHmmss~)
※ファイル名記載のデバイスIDと日付は参考数字です。
NNは01(マイナンバーカード+公費)、02(保険証単体)、03(保険証+公費)
・公費画像JPGと保険証画像JPGはファイル名末尾の0109で判別が可能です。
・保険証利用時のみ、ファイル名に生年月日が含まれます(マイナンバーカードの場合は資格確認結果の戻り値を正とするため)。
 ※但し、券面から生年月日のOCR取得が失敗した場合は『99999999』の8桁がセットされます。
・ファイル生成の時刻とXMLファイルの処理実行日時(ProcessExecutionTime)は数秒のズレが生じることがございます。
 
 
★参考(保険証+公費の組み合わせの例)
※保険証、公費医療券ともにサンプル券面です。
 
券面画像(JPG形式)
ファイル名:ALMocr03res_19411111_F0almex1_20221115103421_01.jpg
 
ファイル名:ALMocr03res_19411111_F0almex1_20221115103421_09.jpg
 
読取結果(XML形式)
ファイル名:ALMocr03res_19411111_F0almex1_20221115103421.xml
 
 
★参考(保険証OCRで生年月日の取得に失敗した場合の例)
 
券面画像(JPG形式)
ファイル名:ALMocr02res_99999999_F0almex1_20220406154533_09.jpg
 
 
読取結果(XML形式)
ファイル名:ALMocr02res_99999999_F0almex1_20220406154533.xmll
※OCRで生年月日の取得を失敗した場合
 
 
連携プログラムの作成にあたり、詳細確認やお打合せ等必要な場合は下記お問い合わせフォーム(お問い合わせはこちら)よりお問い合わせください。
検索キーワード
仕様

サービス改善に役立ててまいりますので、アンケートにご協力ください。

コメント欄 入力いただいた情報は、今後の対応に役立てます。

メール問い合わせ