Azure Logic Apps에 대한 규약의 X12 메시지 설정에 대한 참조

아티클
08/17/2023

적용 대상: Azure Logic Apps(사용량 + 표준)

이 참조에서는 거래 업체 간의 메시지를 처리하는 방법을 지정하기 위해 X12 계약에서 설정할 수 있는 속성에 대해 설명합니다. 사용자와 메시지를 교환하는 파트너와의 규약에 따라 이러한 속성을 설정합니다.

X12 수신 설정

인바운드 메시지에 대한 Azure Portal 및 X12 규약 설정을 보여 주는 스크린샷

식별자

속성	Description
ISA1(권한 부여 한정자)	사용할 권한 부여 한정자 값입니다. 기본값은 00 - 권한 부여 정보 없음입니다. 참고: 다른 값을 선택하는 경우 ISA2 속성의 값을 지정해야 합니다.
ISA2	ISA1 속성이 00 - 권한 부여 정보 없음이 아닌 경우에 사용할 권한 부여 정보 값입니다. 이 속성 값은 1개 이상 10개 이하의 영숫자 문자를 포함해야 합니다.
ISA3(보안 한정자)	사용할 보안 한정자 값입니다. 기본값은 00 - 보안 정보 없음입니다. 참고: 다른 값을 선택하는 경우 ISA4 속성의 값을 지정해야 합니다.
ISA4	ISA3 속성이 00 - 보안 정보 없음이 아닌 경우에 사용할 보안 정보 값입니다. 이 속성 값은 1개 이상 10개 이하의 영숫자 문자를 포함해야 합니다.

승인

속성	Description
TA1이 예상됨	교환 보낸 사람에게 기술 승인(TA1)을 반환합니다.
FA가 예상됨	교환 보낸 사람에게 기능 승인(FA)을 반환합니다. FA Version 속성의 경우 스키마 버전에 따라 997 또는 999 승인을 선택합니다. 수락된 트랜잭션 세트의 기능 승인에서 AK2 루프를 생성할 수 있도록 설정하려면 AK2/IK2 루프 포함을 선택합니다.

스키마

이 섹션에서는 각 트랜잭션 유형(ST01) 및 발신자 애플리케이션(GS02)의 통합 계정에서 스키마를 선택합니다. EDI 수신 파이프라인은 이 섹션에서 설정한 값과 스키마를 들어오는 메시지의 ST01 및 GS02 값 그리고 들어오는 메시지의 스키마와 매칭하여 들어오는 메시지를 디스어셈블합니다. 각 행을 완료하면 비어 있는 새 행이 자동으로 표시됩니다.

속성	Description
버전	스키마의 X12 버전
트랜잭션 유형(ST01)	트랜잭션 유형
발신자 애플리케이션(GS02)	발신자 애플리케이션
스키마	사용하려는 스키마 파일

봉투

속성	Description
ISA11 사용	트랜잭션 세트에 사용할 구분 기호: - 표준 식별자: EDI 수신 파이프라인에서 들어오는 문서의 소수 표기법 대신 소수 표기법에 마침표(.)를 사용합니다. - 반복 구분 기호: 단순 데이터 요소 또는 반복되는 데이터 구조의 반복 발생에 대한 구분 기호를 지정합니다. 예를 들어 일반적으로 캐럿(^)을 반복 구분 기호로 사용합니다. HIPAA 스키마의 경우 캐럿만 사용할 수 있습니다.

속성

Description

ISA11 사용

트랜잭션 세트에 사용할 구분 기호:

- 표준 식별자: EDI 수신 파이프라인에서 들어오는 문서의 소수 표기법 대신 소수 표기법에 마침표(.)를 사용합니다.

- 반복 구분 기호: 단순 데이터 요소 또는 반복되는 데이터 구조의 반복 발생에 대한 구분 기호를 지정합니다. 예를 들어 일반적으로 캐럿(^)을 반복 구분 기호로 사용합니다. HIPAA 스키마의 경우 캐럿만 사용할 수 있습니다.

컨트롤 번호

속성	Description
교환 컨트롤 번호 중복 허용 안 함	중복 교환을 차단합니다. 받은 교환 컨트롤 번호의 교환 컨트롤 번호(ISA13)를 확인합니다. 일치하는 항목이 발견되면 EDI 수신 파이프라인은 교환을 처리하지 않습니다. 확인 작업을 수행할 일 수를 지정하려면 매일 중복 ISA13 확인의 값을 입력합니다.
그룹 컨트롤 번호 중복 허용 안 함	그룹 컨트롤 번호가 중복된 교환을 차단합니다.
트랜잭션 세트 컨트롤 번호 중복 허용 안 함	트랜잭션 세트 컨트롤 번호가 중복된 교환을 차단합니다.

유효성 검사

기본값 행은 EDI 메시지 유형에 사용되는 유효성 검사 규칙을 보여줍니다. 다른 규칙을 정의하려면 규칙을 true로 설정하려는 각 상자를 선택합니다. 각 행을 완료하면 비어 있는 새 행이 자동으로 표시됩니다.

속성	Description
메시지 유형	EDI 메시지 유형
EDI 유효성 검사	스키마의 EDI 속성, 길이 제한, 빈 데이터 요소 및 후행 구분 기호로 정의되는 데이터 형식에 대해 EDI 유효성 검사를 수행합니다.
확장 유효성 검사	데이터 형식이 EDI가 아니면 데이터 요소 요구 사항 및 허용되는 반복, 열거, 데이터 요소 길이 유효성 검사(최솟값 또는 최댓값)에 대한 유효성 검사가 수행됩니다.
선행/후행 0 허용	추가되는 선행 또는 후행 0과 공백 문자를 보존합니다. 이러한 문자를 제거하지 마십시오.
선행/후행 0 자르기	선행 또는 후행 0과 공백 문자를 제거합니다.
후행 구분 기호 정책	후행 구분 기호를 생성합니다. - 허용되지 않음: 인바운드 교환에서 후행 구분 기호를 금지합니다. 이 경우 교환에 후행 구분 기호가 있으면 잘못된 것으로 선언됩니다. - 선택 사항: 후행 구분 기호의 존재 여부에 관계없이 교환을 수락합니다. - 필수: 인바운드 교환에 후행 구분 기호가 있어야 합니다.

내부 설정

속성	Description
10진수 형식 Nn을 밑수 10 숫자 값으로 변환	"Nn" 형식으로 지정된 EDI 번호를 밑수가 10인 숫자 값으로 변환합니다.
후행 구분 기호가 허용되는 경우 빈 XML 태그 만들기	교환 발신자가 후행 구분 기호에 대한 빈 XML 태그를 포함하게 합니다.
교환을 트랜잭션 세트로 분할 - 오류 발생 시 트랜잭션 세트 일시 중단	적절한 봉투를 트랜잭션 세트에 적용하여 교환의 각 트랜잭션 세트를 별도의 XML 문서로 구문 분석합니다. 유효성 검사에 실패한 트랜잭션만 일시 중단합니다.
교환을 트랜잭션 세트로 분할 - 오류 발생 시 교환 일시 중단	적절한 봉투를 적용하여 교환의 각 트랜잭션 세트를 별도의 XML 문서로 구문 분석합니다. 교환에 포함된 하나 이상의 트랜잭션 집합에 대한 유효성 검사가 실패하는 경우 전체 교환을 일시 중단합니다.
교환 유지 - 오류 발생 시 트랜잭션 세트 일시 중단	교환을 그대로 유지하고 일괄 처리된 교환 전체에 대한 XML 문서를 만듭니다. 유효성 검사를 실패하는 트랜잭션 세트만 일시 중단하고, 그 외의 트랜잭션 세트를 계속 처리합니다.
교환 유지 - 오류 발생 시 교환 일시 중단	교환을 그대로 유지하고 배치로 처리된 교환 전체에 대한 XML 문서를 만듭니다. 교환에 포함된 하나 이상의 트랜잭션 집합에 대한 유효성 검사가 실패하는 경우 전체 교환을 일시 중단합니다.

X12 송신 설정

아웃바운드 메시지에 대한 Azure Portal 및 X12 규약 설정을 보여 주는 스크린샷

식별자

속성	Description
ISA1(권한 부여 한정자)	사용할 권한 부여 한정자 값입니다. 기본값은 00 - 권한 부여 정보 없음입니다. 참고: 다른 값을 선택하는 경우 ISA2 속성의 값을 지정해야 합니다.
ISA2	ISA1 속성이 00 - 권한 부여 정보 없음이 아닌 경우에 사용할 권한 부여 정보 값입니다. 이 속성 값은 1개 이상 10개 이하의 영숫자 문자를 포함해야 합니다.
ISA3(보안 한정자)	사용할 보안 한정자 값입니다. 기본값은 00 - 보안 정보 없음입니다. 참고: 다른 값을 선택하는 경우 ISA4 속성의 값을 지정해야 합니다.
ISA4	ISA3 속성이 00 - 보안 정보 없음이 아닌 경우에 사용할 보안 정보 값입니다. 이 속성 값은 1개 이상 10개 이하의 영숫자 문자를 포함해야 합니다.

승인

속성	Description
TA1이 예상됨	교환 보낸 사람에게 기술 승인(TA1)을 반환합니다. 이 설정은 메시지를 보내는 호스트 파트너가 규약의 게스트 파트너로부터 승인을 요청하도록 지정합니다. 규약의 수신 설정에 따라 호스트 파트너에는 이러한 승인이 필요합니다.
FA가 예상됨	교환 보낸 사람에게 기능 승인(FA)을 반환합니다. FA Version 속성의 경우 스키마 버전에 따라 997 또는 999 승인을 선택합니다. 이 설정은 메시지를 보내는 호스트 파트너가 규약의 게스트 파트너로부터 승인을 요청하도록 지정합니다. 규약의 수신 설정에 따라 호스트 파트너에는 이러한 승인이 필요합니다.

속성

Description

TA1이 예상됨

교환 보낸 사람에게 기술 승인(TA1)을 반환합니다.

이 설정은 메시지를 보내는 호스트 파트너가 규약의 게스트 파트너로부터 승인을 요청하도록 지정합니다. 규약의 수신 설정에 따라 호스트 파트너에는 이러한 승인이 필요합니다.

FA가 예상됨

교환 보낸 사람에게 기능 승인(FA)을 반환합니다. FA Version 속성의 경우 스키마 버전에 따라 997 또는 999 승인을 선택합니다.

이 설정은 메시지를 보내는 호스트 파트너가 규약의 게스트 파트너로부터 승인을 요청하도록 지정합니다. 규약의 수신 설정에 따라 호스트 파트너에는 이러한 승인이 필요합니다.

스키마

이 섹션에서는 각 트랜잭션 유형(ST01)의 통합 계정에서 스키마를 선택합니다. 각 행을 완료하면 비어 있는 새 행이 자동으로 표시됩니다.

속성	Description
버전	스키마의 X12 버전
트랜잭션 유형(ST01)	스키마의 트랜잭션 유형입니다.
스키마	사용하려는 스키마 파일입니다. 스키마를 먼저 선택하면 버전과 트랜잭션 유형이 자동으로 설정됩니다.

봉투

속성	Description
ISA11 사용	트랜잭션 세트에 사용할 구분 기호: - 표준 식별자: EDI 송신 파이프라인에서 아웃바운드 문서의 소수 표기법 대신 소수 표기법에 마침표(.)를 사용합니다. - 반복 구분 기호: 단순 데이터 요소 또는 반복되는 데이터 구조의 반복 발생에 대한 구분 기호를 지정합니다. 예를 들어 일반적으로 캐럿(^)을 반복 구분 기호로 사용합니다. HIPAA 스키마의 경우 캐럿만 사용할 수 있습니다.

속성

Description

ISA11 사용

트랜잭션 세트에 사용할 구분 기호:

- 표준 식별자: EDI 송신 파이프라인에서 아웃바운드 문서의 소수 표기법 대신 소수 표기법에 마침표(.)를 사용합니다.

- 반복 구분 기호: 단순 데이터 요소 또는 반복되는 데이터 구조의 반복 발생에 대한 구분 기호를 지정합니다. 예를 들어 일반적으로 캐럿(^)을 반복 구분 기호로 사용합니다. HIPAA 스키마의 경우 캐럿만 사용할 수 있습니다.

컨트롤 버전 번호

이 섹션에서는 각 교환의 통합 계정에서 스키마를 선택합니다. 각 행을 완료하면 비어 있는 새 행이 자동으로 표시됩니다.

속성	Description
컨트롤 버전 번호(ISA12)	X12 표준 버전
사용 표시기(ISA15)	교환의 컨텍스트이며 테스트 데이터, 정보 데이터 또는 프로덕션 데이터 중 하나입니다.
스키마	EDI 송신 파이프라인으로 보내는 X12 인코딩 교환에 대한 GS 및 ST 세그먼트를 생성하는 데 사용되는 스키마입니다.
GS1	선택 사항으로, 함수 코드를 선택합니다.
GS2	선택 사항으로, 애플리케이션 발신자를 지정합니다.
GS3	선택 사항으로, 애플리케이션 수신자를 지정합니다.
GS4	선택 사항으로, CCYYMMDD 또는 YYMMDD를 선택합니다.
GS5	선택 사항으로, HHMM, HHMMSS 또는 HHMMSSdd를 선택합니다.
GS7	선택 사항으로, 담당 에이전시의 값을 선택합니다.
GS8	선택 사항으로, 스키마 문서 버전을 지정합니다.

컨트롤 번호

속성	Description
교환 컨트롤 번호(ISA13)	교환 컨트롤 번호의 값 범위로, 최솟값은 1이고 최댓값은 999999999입니다.
그룹 컨트롤 번호(GS06)	그룹 컨트롤 번호의 값 범위로, 최솟값은 1이고 최댓값은 999999999입니다.
트랜잭션 세트 컨트롤 번호(ST02)	트랜잭션 세트 컨트롤 번호의 값 범위로, 최솟값은 1이고 최댓값은 999999999입니다. - 접두사: 선택 사항으로, 영숫자 값입니다. - 접미사: 선택 사항으로, 영숫자 값입니다.

문자 집합 및 구분 기호

기본 행은 메시지 스키마의 구분 기호로 사용되는 문자 세트를 표시합니다. 기본 문자 세트를 사용하지 않으려면 각 메시지 유형에 다른 구분 기호 세트를 입력하면 됩니다. 각 행을 완료하면 비어 있는 새 행이 자동으로 표시됩니다.

팁

특수 문자 값을 제공하려면 JSON으로 계약을 편집하고 특수 문자에 대한 ASCII 값을 제공합니다.

속성	Description
사용할 문자 세트	X12 문자 세트이며 기본, 확장또는 UTF8입니다.
스키마	사용하려는 스키마입니다. 스키마를 선택한 후에는 아래의 구분 기호 설명에 따라 사용하려는 문자 세트를 선택합니다.
입력 형식	문자 세트의 입력 형식
구성 요소 구분 기호	복합 데이터 요소를 분리하는 단일 문자
데이터 요소 구분 기호	복합 데이터 내에서 단순 데이터 요소를 분리하는 단일 문자
대체 문자 구분 기호	아웃바운드 X12 메시지를 생성할 때 페이로드 데이터에 있는 모든 구분 기호 문자를 대체하는 대체 문자
세그먼트 마침 표시	EDI 세그먼트의 끝을 나타내는 단일 문자
접미사	세그먼트 식별자와 함께 사용할 문자. 접미사를 지정하면 세그먼트 마침 표시 데이터 요소를 비워 둘 수 있습니다. 세그먼트 마침 표시를 비워 두는 경우에는 반드시 접미사를 지정해야 합니다.

유효성 검사

속성	Description
메시지 유형	EDI 메시지 유형
EDI 유효성 검사	스키마의 EDI 속성, 길이 제한, 빈 데이터 요소 및 후행 구분 기호로 정의되는 데이터 형식에 대해 EDI 유효성 검사를 수행합니다.
확장 유효성 검사	데이터 형식이 EDI가 아니면 데이터 요소 요구 사항 및 허용되는 반복, 열거, 데이터 요소 길이 유효성 검사(최솟값 또는 최댓값)에 대한 유효성 검사가 수행됩니다.
선행/후행 0 허용	추가되는 선행 또는 후행 0과 공백 문자를 보존합니다. 이러한 문자를 제거하지 마십시오.
선행/후행 0 자르기	선행 또는 후행 0과 공백 문자를 제거합니다.
후행 구분 기호 정책	후행 구분 기호를 생성합니다. - 허용되지 않음: 아웃바운드 교환에서 후행 구분 기호를 금지합니다. 이 경우 교환에 후행 구분 기호가 있으면 잘못된 것으로 선언됩니다. - 선택 사항: 후행 구분 기호의 존재 여부에 관계없이 교환을 보냅니다. - 필수: 아웃바운드 교환에 후행 구분 기호가 있어야 합니다.

HIPAA 스키마 및 메시지 유형

HIPAA 스키마 및 277 또는 837 메시지 유형을 사용하는 경우 몇 가지 추가 단계를 수행해야 합니다. 이러한 메시지 유형의 문서 버전 번호(GS8)에는 10자 이상의 문자가 포함됩니다(예: ‘005010X222A1’). 또한 일부 문서 버전 번호는 변형 메시지 유형에 매핑됩니다. 스키마 및 규약에서 올바른 메시지 유형을 참조하지 않으면 다음 오류 메시지가 표시됩니다.

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

다음 테이블에는 영향을 받는 메시지 유형, 모든 변형, 해당 메시지 유형에 매핑되는 문서 버전 번호가 나열됩니다.

메시지 유형 또는 변형	Description	문서 버전 번호(GS8)
277	의료 보험 정보 상태 통지	005010X212
837_I	의료 보험 청구 기관	004010X096A1 005010X223A1 005010X223A2
837_D	의료 보험 청구 치과	004010X097A1 005010X224A1 005010X224A2
837_P	의료 보험 청구 전문가	004010X098A1 005010X222 005010X222A1

또한 이러한 문서 버전 번호를 사용하면 문자 길이가 잘못되었다는 오류가 발생하므로 EDI 유효성 검사를 사용하지 않도록 설정해야 합니다.

이러한 문서 버전 번호와 메시지 유형을 지정하려면 다음 단계를 수행합니다.

HIPAA 스키마에서 현재 메시지 유형을 사용하려는 문서 버전 번호의 변형 메시지 유형으로 바꿉니다.

예를 들어 메시지 유형 837에 문서 버전 번호 005010X222A1을 사용하려 한다고 가정해 보겠습니다. 스키마에서 각 "X12_00501_837" 값을 "X12_00501_837_P" 값으로 바꿉니다.

스키마를 업데이트하려면 다음 단계를 수행합니다.
1. Azure Portal에서 통합 계정으로 이동합니다. 해당 스키마를 찾아서 다운로드합니다. 메시지 유형을 바꾸고, 스키마 파일의 이름을 바꾸고, 수정된 스키마를 통합 계정에 업로드합니다. 자세한 내용은 스키마 편집을 참조하세요.
2. 규약의 메시지 설정에서 수정된 스키마를 선택합니다.
규약의 schemaReferences 개체에서 문서 버전 번호와 일치하는 변형 메시지 유형을 지정하는 또 다른 항목을 추가합니다.

예를 들어 메시지 유형 837에 문서 버전 번호 005010X222A1을 사용하려 한다고 가정하겠습니다. 규약에는 다음과 같은 속성과 값을 가진 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 수신 설정

식별자

승인

스키마

봉투

컨트롤 번호

유효성 검사

내부 설정

X12 송신 설정

식별자

승인

스키마

봉투

컨트롤 버전 번호

컨트롤 번호

문자 집합 및 구분 기호

유효성 검사

HIPAA 스키마 및 메시지 유형

다음 단계

추가 리소스