Azure Logic Apps の契約での X12 メッセージの設定に関するリファレンス

[アーティクル]
08/21/2023

適用対象: Azure Logic Apps (従量課金 + Standard)

このリファレンスでは、取引先間のメッセージを処理する方法を指定するために X12 契約で設定できるプロパティについて説明します。メッセージを交換するパートナーとの契約に基づいて、これらのプロパティを設定します。

X12 の受信設定

Azure portal と受信メッセージ用の X12 契約の設定を示すスクリーンショット。

識別子

プロパティ	説明
ISA1 (Authorization Qualifier) (ISA1 (認証修飾子))	使用する認証修飾子の値。既定値は、 [00 - No Authorization Information Present](00 - 認証情報が存在しません) です。注:他の値を選択する場合は、ISA2 プロパティの値を指定します。
ISA2	ISA1 プロパティが [00 - No Authorization Information Present](00 - 認証情報が存在しません) でない場合に使用する認証情報の値。このプロパティ値には、1 文字以上で 10 文字以下の英数字を入力する必要があります。
ISA3 (Security Qualifier) (ISA3 (セキュリティ修飾子))	使用するセキュリティ修飾子の値。既定値は、 [00 - No Security Information Present](00 - セキュリティ情報が存在しません) です。注:他の値を選択する場合は、ISA4 プロパティの値を指定します。
ISA4	ISA3 プロパティが [00 - No Security Information Present](00 - セキュリティ情報が存在しません) でない場合に使用するセキュリティ情報の値。このプロパティ値には、1 文字以上で 10 文字以下の英数字を入力する必要があります。

Acknowledgement (受信確認)

プロパティ	説明
TA1 Expected (TA1 が必要)	インターチェンジの送信者に技術確認 (TA1) を返します。
FA Expected (FA が必要)	インターチェンジの送信者に機能確認 (FA) を返します。 FA Version (FA バージョン) プロパティについては、スキーマのバージョンに基づいて、997 または 999 の受信確認を選択します。受理されたトランザクションセットの機能確認で AK2 ループの生成を有効にするには、 [Include AK2 / IK2 Loop](AK2 / IK2 ループを含める) を選択します。

プロパティ

説明

TA1 Expected (TA1 が必要)

インターチェンジの送信者に技術確認 (TA1) を返します。

FA Expected (FA が必要)

インターチェンジの送信者に機能確認 (FA) を返します。

FA Version (FA バージョン) プロパティについては、スキーマのバージョンに基づいて、997 または 999 の受信確認を選択します。

受理されたトランザクションセットの機能確認で AK2 ループの生成を有効にするには、 [Include AK2 / IK2 Loop](AK2 / IK2 ループを含める) を選択します。

スキーマ

このセクションについては、各トランザクションの種類 (ST01) と送信側アプリケーション (GS02) に対して統合アカウントからスキーマを選択します。 EDI 受信パイプラインは、このセクションで設定された値とスキーマを、受信メッセージの ST01 と GS02 の値および受信メッセージのスキーマと照合することにより、受信メッセージを逆アセンブルします。行を 1 つ完了するたびに、新しい空の行が自動的に表示されます。

プロパティ	説明
Version	スキーマの X12 バージョン
Transaction Type (ST01) (トランザクションの種類 (ST01))	トランザクションの種類
Sender Application (GS02) (送信側アプリケーション (GS02))	送信側アプリケーション
[スキーマ]	使用するスキーマファイル

エンベロープ

プロパティ	説明
ISA11 Usage (ISA11 の使用)	トランザクションセットで使用する区切り記号: - 標準識別子: EDI 受信パイプラインの受信ドキュメントの 10 進数表記ではなく、ピリオド (.) を 10 進数表記に使用します。 - 繰り返し区切り記号: 繰り返し出現する単純なデータ要素または繰り返されるデータ構造体の区切り記号を指定します。たとえば、繰り返し区切り記号としては通常、キャレット (^) が使用されます。 HIPAA スキーマに対しては、キャレットのみ使用できます。

プロパティ

説明

ISA11 Usage (ISA11 の使用)

トランザクションセットで使用する区切り記号:

- 標準識別子: EDI 受信パイプラインの受信ドキュメントの 10 進数表記ではなく、ピリオド (.) を 10 進数表記に使用します。

- 繰り返し区切り記号: 繰り返し出現する単純なデータ要素または繰り返されるデータ構造体の区切り記号を指定します。たとえば、繰り返し区切り記号としては通常、キャレット (^) が使用されます。 HIPAA スキーマに対しては、キャレットのみ使用できます。

制御番号

プロパティ	説明
Disallow Interchange control number duplicates (インターチェンジ制御番号の重複を許可しない)	重複したインターチェンジを防止します。受信したインターチェンジ制御番号に対して、インターチェンジ制御番号 (ISA13) をチェックします。一致が検出されると、EDI 受信パイプラインはインターチェンジを処理しません。チェックを実行する日数を指定するには、Check for duplicate ISA13 every (days)(ISA13 の重複の確認間隔 (日単位)) プロパティに値を指定します。
Disallow Group control number duplicates (グループ制御番号の重複を許可しない)	重複するグループ制御番号を持つインターチェンジをブロックします。
Disallow Transaction set control number duplicates (トランザクションセット制御番号の重複を許可しない)	重複するトランザクションセット制御番号を持つインターチェンジをブロックします。

確認

[Default](既定) 行には、EDI メッセージ型に使用される検証ルールが表示されます。別のルールを定義する場合は、ルールを true に設定する各ボックスを選択します。行を 1 つ完了するたびに、新しい空の行が自動的に表示されます。

プロパティ	説明
Message Type (メッセージ型)	EDI メッセージ型
EDI Validation (EDI 検証)	スキーマの EDI プロパティ、長さ制限、空のデータ要素、および末尾の区切り記号で定義されたデータ型で EDI 検証を実行します。
Extended Validation (拡張検証)	データ型が EDI でない場合は、検証はデータ要素の要件と許可される繰り返し、列挙、およびデータ要素の長さの検証 (最小または最大) に対して実行されます。
Allow Leading/Trailing Zeroes (先頭および末尾のゼロを許可)	追加の先頭または末尾のゼロと空白文字をすべて保持します。これらの文字を削除しません。
Trim Leading/Trailing Zeroes (先頭および末尾のゼロをトリミングする)	先頭または末尾のゼロと空白文字をすべて削除します。
末尾の区切り記号のポリシー	末尾の区切り記号を生成します。 - Not Allowed (禁止) : 受信インターチェンジの末尾の区切り記号や区切り文字を禁止します。インターチェンジに末尾の区切り記号や区切り文字が含まれている場合、インターチェンジは無効と宣言されます。 - Optional (省略可能) : 末尾の区切り記号や区切り文字の有無に関係なくインターチェンジを受け入れます。 - Mandatory (必須) : 受信インターチェンジは、末尾の区切り記号や区切り文字を持っている必要があります。

Internal Settings (内部設定)

プロパティ	説明
Convert implied decimal format Nn to a base 10 numeric value (暗黙的に指定された 10 進形式 Nn を底 10 の数値に変換する)	形式 "Nn" で指定されている EDI 番号を底 10 の数値に変換します。
Create empty XML tags if trailing separators are allowed (末尾の区切り記号が許可されている場合は空の XML タグを作成する)	インターチェンジの送信者に、末尾の区切り記号用の空の XML タグを含めさせます。
Split Interchange as transaction sets - suspend transaction sets on error (インターチェンジをトランザクションセットとして分割 - エラー発生時にトランザクションセットを中断)	トランザクションセットに適切なエンベロープを適用することで、インターチェンジ内の各トランザクションセットを個別の XML ドキュメントで解析します。検証に失敗したトランザクションのみを中断します。
Split Interchange as transaction sets - suspend interchange on error (インターチェンジをトランザクションセットとして分割 - エラー発生時にインターチェンジを中断)	適切なエンベロープを適用することで、インターチェンジ内の各トランザクションセットを個別の XML ドキュメントで解析します。インターチェンジの 1 つ以上のトランザクションセットが検証に失敗した場合、インターチェンジ全体を中断します。
Preserve Interchange - suspend transaction sets on error (インターチェンジの保存 - エラー発生時にトランザクションセットを中断)	インターチェンジはそのままにして、バッチインターチェンジ全体に対する XML ドキュメントを作成します。検証に失敗したトランザクションセットだけを中断し、他のすべてのトランザクションセットの処理を継続します。
Preserve Interchange - suspend interchange on error (インターチェンジの保存 - エラー発生時にインターチェンジを中断)	インターチェンジはそのままにして、バッチインターチェンジ全体に対する XML ドキュメントを作成します。インターチェンジの 1 つ以上のトランザクションセットが検証に失敗した場合、インターチェンジ全体を中断します。

X12 の送信設定

Azure portal と送信メッセージ用の X12 契約の設定を示すスクリーンショット。

識別子

プロパティ	説明
ISA1 (Authorization Qualifier) (ISA1 (認証修飾子))	使用する認証修飾子の値。既定値は、 [00 - No Authorization Information Present](00 - 認証情報が存在しません) です。注:他の値を選択する場合は、ISA2 プロパティの値を指定します。
ISA2	ISA1 プロパティが [00 - No Authorization Information Present](00 - 認証情報が存在しません) でない場合に使用する認証情報の値。このプロパティ値には、1 文字以上で 10 文字以下の英数字を入力する必要があります。
ISA3 (Security Qualifier) (ISA3 (セキュリティ修飾子))	使用するセキュリティ修飾子の値。既定値は、 [00 - No Security Information Present](00 - セキュリティ情報が存在しません) です。注:他の値を選択する場合は、ISA4 プロパティの値を指定します。
ISA4	ISA3 プロパティが [00 - No Security Information Present](00 - セキュリティ情報が存在しません) でない場合に使用するセキュリティ情報の値。このプロパティ値には、1 文字以上で 10 文字以下の英数字を入力する必要があります。

Acknowledgement (受信確認)

プロパティ	説明
TA1 Expected (TA1 が必要)	インターチェンジの送信者に技術確認 (TA1) を返します。この設定は、メッセージを送信しているホストパートナーが、契約でゲストパートナーからの受信確認を要求することを指定します。ホストパートナーは、契約の [受信設定] に基づいてこれらの受信確認を想定しています。
FA Expected (FA が必要)	インターチェンジの送信者に機能確認 (FA) を返します。 FA Version (FA バージョン) プロパティについては、スキーマのバージョンに基づいて、997 または 999 の受信確認を選択します。この設定は、メッセージを送信しているホストパートナーが、契約でゲストパートナーからの受信確認を要求することを指定します。ホストパートナーは、契約の [受信設定] に基づいてこれらの受信確認を想定しています。

プロパティ

説明

TA1 Expected (TA1 が必要)

インターチェンジの送信者に技術確認 (TA1) を返します。

この設定は、メッセージを送信しているホストパートナーが、契約でゲストパートナーからの受信確認を要求することを指定します。ホストパートナーは、契約の [受信設定] に基づいてこれらの受信確認を想定しています。

FA Expected (FA が必要)

インターチェンジの送信者に機能確認 (FA) を返します。 FA Version (FA バージョン) プロパティについては、スキーマのバージョンに基づいて、997 または 999 の受信確認を選択します。

この設定は、メッセージを送信しているホストパートナーが、契約でゲストパートナーからの受信確認を要求することを指定します。ホストパートナーは、契約の [受信設定] に基づいてこれらの受信確認を想定しています。

スキーマ

このセクションについては、各トランザクションの種類 (ST01) に対して統合アカウントからスキーマを選択します。行を 1 つ完了するたびに、新しい空の行が自動的に表示されます。

プロパティ	説明
Version	スキーマの X12 バージョン
Transaction Type (ST01) (トランザクションの種類 (ST01))	スキーマのトランザクションの種類
[スキーマ]	使用するスキーマファイル。最初にスキーマを選択すると、バージョンとトランザクションの種類が自動的に設定されます。

エンベロープ

プロパティ	説明
ISA11 Usage (ISA11 の使用)	トランザクションセットで使用する区切り記号: - Standard Identifier (標準識別子) : EDI 送信パイプラインの送信ドキュメントの 10 進数表記ではなく、ピリオド (.) を 10 進数表記に使用します。 - Repetition Separator (繰り返し区切り記号) : 繰り返し出現する単純なデータ要素または繰り返されるデータ構造体の区切り記号を指定します。たとえば、繰り返し区切り記号としては通常、キャレット (^) が使用されます。 HIPAA スキーマに対しては、キャレットのみ使用できます。

プロパティ

説明

ISA11 Usage (ISA11 の使用)

トランザクションセットで使用する区切り記号:

- Standard Identifier (標準識別子) : EDI 送信パイプラインの送信ドキュメントの 10 進数表記ではなく、ピリオド (.) を 10 進数表記に使用します。

- Repetition Separator (繰り返し区切り記号) : 繰り返し出現する単純なデータ要素または繰り返されるデータ構造体の区切り記号を指定します。たとえば、繰り返し区切り記号としては通常、キャレット (^) が使用されます。 HIPAA スキーマに対しては、キャレットのみ使用できます。

制御バージョン番号

このセクションについては、各インターチェンジに対して統合アカウントからスキーマを選択します。行を 1 つ完了するたびに、新しい空の行が自動的に表示されます。

プロパティ	説明
Control Version Number (ISA12) (制御バージョン番号 (ISA12))	X12 標準のバージョン
Usage Indicator (ISA15) (使用状況インジケーター (ISA15))	インターチェンジのコンテキスト。 [Test](テスト) データ、 [Information](情報) データ、または [Production](運用) データのいずれか
[スキーマ]	EDI 送信パイプラインに送信される X12 エンコードインターチェンジの GS および ST セグメントの生成に使用するスキーマ。
GS1	省略可能。機能コードを選択します。
GS2	省略可能。アプリケーション送信者を指定します。
GS3	省略可能。アプリケーション受信者を指定します。
GS4	省略可能。 [CCYYMMDD] または [YYMMDD] を選択します。
GS5	省略可能。 [HHMM] 、 [HHMMSS] 、または [HHMMSSdd] を選択します。
GS7	省略可能。担当機関の値を選択します。
GS8	省略可能。スキーマドキュメントのバージョンを指定します。

制御番号

プロパティ	説明
Interchange Control Number (ISA13) (インターチェンジ制御番号 (ISA13))	インターチェンジ制御番号の値の範囲。最小値は 1、最大値は 999999999 です
Group Control Number (GS06) (グループ制御番号 (GS06))	グループ制御番号の値の範囲。最小値は 1、最大値は 999999999 です
Transaction Set Control Number (ST02) (トランザクションセット制御番号 (ST02))	トランザクションセット制御番号の値の範囲。最小値は 1、最大値は 999999999 です - Prefix (プレフィックス) : 省略可能。英数字の値 - Suffix (サフィックス) : 省略可能。英数字の値

Character Sets and Separators (文字セットと区切り文字)

[Default](既定) 行には、メッセージスキーマの区切り記号として使用される文字セットが表示されます。既定の文字セットを使用しない場合は、メッセージ型ごとに異なる区切り記号セットを入力できます。行を 1 つ完了するたびに、新しい空の行が自動的に表示されます。

ヒント

特殊文字の値を指定するには、契約を JSON として編集し、特殊文字の ASCII 値を指定します。

プロパティ	説明
Character Set to be used (使用する文字セット)	X12 文字セット。 [Basic](基本)\ 、 [Extended](拡張) 、または [UTF8] のいずれか。
[スキーマ]	使用するスキーマ。スキーマを選択した後、次の区切り記号の説明に基づいて、使用する文字セットを選択します。
[Input Type](入力の種類)	文字セットの入力の種類
Component Separator (コンポーネントの区切り記号)	複合データ要素を区切る 1 文字
Data Element Separator (データ要素区切り記号)	複合データ内の単純データ要素を区切る 1 文字
replacement Character Separator (置換文字の区切り記号)	X12 送信メッセージを生成するときにペイロードデータ内のすべての区切り文字を置換する置換文字
Segment Terminator (セグメント終端記号)	EDI セグメントの終端を示す 1 文字
サフィックス	セグメント識別子と共に使用する文字。サフィックスを指定する場合、セグメント終端記号のデータ要素は空にできます。セグメント終端記号を空のままにする場合は、サフィックスを指定する必要があります。

検証

プロパティ	説明
Message Type (メッセージ型)	EDI メッセージ型
EDI Validation (EDI 検証)	スキーマの EDI プロパティ、長さ制限、空のデータ要素、および末尾の区切り記号で定義されたデータ型で EDI 検証を実行します。
Extended Validation (拡張検証)	データ型が EDI でない場合は、検証はデータ要素の要件と許可される繰り返し、列挙、およびデータ要素の長さの検証 (最小または最大) に対して実行されます。
Allow Leading/Trailing Zeroes (先頭および末尾のゼロを許可)	追加の先頭または末尾のゼロと空白文字をすべて保持します。これらの文字を削除しません。
Trim Leading/Trailing Zeroes (先頭および末尾のゼロをトリミングする)	先頭または末尾のゼロと空白文字をすべて削除します。
末尾の区切り記号のポリシー	末尾の区切り記号を生成します。 - Not Allowed (禁止) : 送信インターチェンジの末尾の区切り記号や区切り文字を禁止します。インターチェンジに末尾の区切り記号や区切り文字が含まれている場合、インターチェンジは無効と宣言されます。 - Optional (省略可能) : 末尾の区切り記号や区切り文字の有無に関係なくインターチェンジを送信します。 - Mandatory (必須) : 送信インターチェンジは、末尾の区切り記号や区切り文字を持っている必要があります。

HIPAA スキーマとメッセージ型

HIPAA スキーマと 277 または 837 のメッセージ型を操作する場合は、いくつかの追加手順を実行する必要があります。これらのメッセージ型のドキュメントバージョン番号 (GS8) には、9 文字を超える文字 (たとえば、"005010X222A1") が含まれます。また、一部のドキュメントバージョン番号は、バリアントメッセージ型にマップされます。スキーマおよび契約で正しいメッセージ型を参照していない場合は、次のエラーメッセージが表示されます。

"The message has an unknown document type and did not resolve to any of the existing schemas configured in the agreement."

次の表に、影響を受けるメッセージ型、バリアント、およびそれらのメッセージ型にマップされるドキュメントバージョン番号を示します。

メッセージ型またはバリアント	説明	ドキュメントバージョン番号 (GS8)
277	医療保険情報の状態通知	005010X212
837_I	健康保険請求: 機関	004010X096A1 005010X223A1 005010X223A2
837_D	医療保険請求: 歯科	004010X097A1 005010X224A1 005010X224A2
837_P	健康保険請求: 専門家	004010X098A1 005010X222 005010X222A1

また、これらのドキュメントバージョン番号を使用するときは、文字の長さが無効であるというエラーが発生するため、EDI の検証を無効にする必要があります。

これらのドキュメントバージョン番号とメッセージ型を指定するには、次の手順を実行します。

HIPAA スキーマで、使用するドキュメントバージョン番号に対して、現在のメッセージ型をバリアントメッセージ型に置き換えます。

たとえば、ドキュメントバージョン番号 005010X222A1 を 837 メッセージ型で使用するとします。スキーマでは、それぞれの "X12_00501_837" 値を、代わりに "X12_00501_837_P" 値に置き換えます。

スキーマを更新するには、次の手順を実行します。
1. Azure portal で統合アカウントに移動します。スキーマを検索してダウンロードします。メッセージ型を置き換えて、スキーマファイルの名前を変更し、変更したスキーマを統合アカウントにアップロードします。詳細については、「スキーマを編集する」を参照してください｡
2. 契約のメッセージ設定で、変更後のスキーマを選択します。
契約の schemaReferences オブジェクトで、ドキュメントバージョン番号と一致するバリアントメッセージ型を指定する別のエントリを追加します。

たとえば、ドキュメントバージョン番号 005010X222A1 を 837 メッセージ型で使用するとします。契約には、次のプロパティと値を含む schemaReferences セクションがあります。
```
"schemaReferences": [
   {
      "messageId": "837",
      "schemaVersion": "00501",
      "schemaName": "X12_00501_837"
   }
]
```
この schemaReferences セクションに、次の値を持つ別のエントリを追加します。
- "messageId": "837_P"
- "schemaVersion": "00501"
- "schemaName": "X12_00501_837_P"
完了すると、schemaReferences セクションは次のようになります。
```
"schemaReferences": [
   {
      "messageId": "837",
      "schemaVersion": "00501",
      "schemaName": "X12_00501_837"
   },
   {
      "messageId": "837_P",
      "schemaVersion": "00501",
      "schemaName": "X12_00501_837_P"
   }
]
```
契約のメッセージ設定で、それぞれのメッセージ型、または既定の値を使用している場合はすべてのメッセージ型に対して [EDI 検証] チェックボックスをオフにして、EDI 検証を無効にします。

次のステップ

X12 メッセージの交換

次の方法で共有

Azure Logic Apps の契約での X12 メッセージの設定に関するリファレンス

X12 の受信設定

識別子

Acknowledgement (受信確認)

スキーマ

エンベロープ

制御番号

確認

Internal Settings (内部設定)

X12 の送信設定

識別子

Acknowledgement (受信確認)

スキーマ

エンベロープ

制御バージョン番号

制御番号

Character Sets and Separators (文字セットと区切り文字)

検証

HIPAA スキーマとメッセージ型

次のステップ

フィードバック

その他のリソース