Udostępnij za pośrednictwem


Dokumentacja ustawień komunikatów X12 w umowach dotyczących usługi Azure Logic Apps

Dotyczy: Azure Logic Apps (Zużycie + Standardowa)

W tym dokumentacji opisano właściwości, które można ustawić w umowie X12 na potrzeby określania sposobu obsługi komunikatów między partnerami handlowymi. Skonfiguruj te właściwości na podstawie umowy z partnerem, który wymienia komunikaty z Tobą.

Ustawienia odbierania X12

Zrzut ekranu przedstawiający ustawienia witryny Azure Portal i umowy X12 dla komunikatów przychodzących.

Identifiers

Właściwości opis
ISA1 (kwalifikator autoryzacji) Wartość kwalifikatora autoryzacji, której chcesz użyć. Wartość domyślna to 00 — brak informacji o autoryzacji.

Uwaga: w przypadku wybrania innych wartości określ wartość właściwości ISA2 .
ISA2 Wartość Informacje o autoryzacji do użycia, gdy właściwość ISA1 nie ma wartości 00 — brak informacji o autoryzacji. Ta wartość właściwości musi mieć co najmniej jeden znak alfanumeryczny i maksymalnie 10.
ISA3 (kwalifikator zabezpieczeń) Wartość kwalifikatora zabezpieczeń, której chcesz użyć. Wartość domyślna to 00 — brak informacji zabezpieczających.

Uwaga: w przypadku wybrania innych wartości określ wartość właściwości ISA4 .
ISA4 Wartość Informacje o zabezpieczeniach, która ma być używana, gdy właściwość ISA3 nie ma wartości 00 — brak informacji zabezpieczających. Ta wartość właściwości musi mieć co najmniej jeden znak alfanumeryczny i maksymalnie 10.

Potwierdzenie

Właściwości opis
Oczekiwana ta1 Zwróć potwierdzenie techniczne (TA1) do nadawcy wymiany.
Oczekiwana fa Zwróć potwierdzenie funkcjonalne (FA) do nadawcy wymiany.

Dla właściwości Wersja fa na podstawie wersji schematu wybierz potwierdzenie 997 lub 999.

Aby włączyć generowanie pętli AK2 w potwierdzeniach funkcjonalnych dla akceptowanych zestawów transakcji, wybierz pozycję Uwzględnij pętlę AK2 / IK2.

Schematy

W tej sekcji wybierz schemat z konta integracji dla każdego typu transakcji (ST01) i aplikacji nadawcy (GS02). Potok odbierania EDI dezasembluje komunikat przychodzący, pasując do wartości i schematu ustawionego w tej sekcji z wartościami ST01 i GS02 w komunikacie przychodzącym oraz ze schematem komunikatu przychodzącego. Po zakończeniu każdego wiersza zostanie automatycznie wyświetlony nowy pusty wiersz.

Właściwości opis
Wersja Wersja X12 dla schematu
Typ transakcji (ST01) Typ transakcji
Aplikacja nadawcy (GS02) Aplikacja nadawcy
Schemat Plik schematu, którego chcesz użyć

Koperty

Właściwości opis
Użycie isa11 Separator do użycia w zestawie transakcji:

- Identyfikator standardowy: użyj kropki (.) dla notacji dziesiętnej, a nie notacji dziesiętnej przychodzącego dokumentu w potoku odbierania EDI.

- Separator powtórzeń: określ separator powtarzających się wystąpień prostego elementu danych lub powtarzającej się struktury danych. Na przykład zwykle karat (^) jest używany jako separator powtórzeń. W przypadku schematów HIPAA można używać tylko kareaty.

Numery kontrolne

Właściwości opis
Nie zezwalaj na duplikaty numeru kontrolnego wymiany Blokuj zduplikowane wymiany. Sprawdź numer kontrolny wymiany (ISA13) dla odebranych numerów kontrolnych wymiany. Jeśli zostanie wykryte dopasowanie, potok odbierania EDI nie przetwarza wymiany.



Aby określić liczbę dni do wykonania sprawdzania, wprowadź wartość dla właściwości Check for duplicate ISA13 every (days) (Sprawdzanie pod kątem zduplikowanego isA13 co (dni).
Nie zezwalaj na duplikaty numerów kontrolnych grupy Blokuj wymiany, które mają zduplikowane numery kontrolek grupy.
Nie zezwalaj na duplikaty liczb kontrolnych zestawu transakcji Blokuj wymiany, które mają zduplikowane numery kontrolek zestawu transakcji.

Walidacje

W wierszu Domyślny są wyświetlane reguły sprawdzania poprawności, które są używane dla typu komunikatu EDI. Jeśli chcesz zdefiniować różne reguły, zaznacz każde pole, w którym reguła ma mieć wartość true. Po zakończeniu każdego wiersza zostanie automatycznie wyświetlony nowy pusty wiersz.

Właściwości opis
Typ komunikatu Typ komunikatu EDI
Walidacja EDI Przeprowadź walidację EDI dla typów danych zgodnie z definicją właściwości EDI schematu, ograniczeń długości, pustych elementów danych i separatorów końcowych.
Rozszerzona walidacja Jeśli typ danych nie jest EDI, walidacja dotyczy wymagania elementu danych i dozwolonego powtórzenia, wyliczenia i walidacji długości elementu danych (minimalna lub maksymalna).
Zezwalaj na zera wiodące/końcowe Zachowaj wszelkie dodatkowe znaki wiodące lub końcowe zera i spacji. Nie usuwaj tych znaków.
Przycinanie zer wiodących/końcowych Usuń wszystkie znaki wiodące lub końcowe zera i spacji.
Zasady separatora końcowego Generowanie separatorów końcowych.

- Niedozwolone: uniemożliwia ograniczniki końcowe i separatory w wymianie przychodzącej. Jeśli wymiana zawiera ograniczniki końcowe i separatory, wymiana jest zadeklarowana jako nieprawidłowa.

- Opcjonalnie: Zaakceptuj wymiany z ogranicznikami i separatorami końcowymi lub bez nich.

- Obowiązkowe: Wymiana ruchu przychodzącego musi zawierać końcowe ograniczniki i separatory.

Ustawienia wewnętrzne

Właściwości opis
Konwertowanie sugerowanego formatu dziesiętnego Nn na wartość liczbową podstawową 10 Przekonwertuj liczbę EDI określoną za pomocą formatu "Nn" na wartość liczbową base-10.
Tworzenie pustych tagów XML, jeśli separatory końcowe są dozwolone Nadawca wymiany zawiera puste tagi XML dla separatorów końcowych.
Dzielenie wymiany jako zestawy transakcji — wstrzymywanie zestawów transakcji w przypadku błędu Przeanalizuj każdy zestaw transakcji, który znajduje się w wymiennym dokumencie XML, stosując odpowiednią kopertę do zestawu transakcji. Wstrzymaj tylko transakcje, w których walidacja kończy się niepowodzeniem.
Dzielenie wymiany jako zestawy transakcji — wstrzymywanie wymiany przy błędzie Przeanalizuj każdy zestaw transakcji, który znajduje się w wymiennym dokumencie XML, stosując odpowiednią kopertę. Wstrzymaj całą wymianę, gdy co najmniej jeden zestaw transakcji w ramach walidacji wymiany zakończy się niepowodzeniem.
Zachowaj wymianę — wstrzymywanie zestawów transakcji w przypadku błędu Pozostaw wymianę nienaruszoną i utwórz dokument XML dla całej wymiany wsadowej. Wstrzymaj tylko zestawy transakcji, które kończą się niepowodzeniem weryfikacji, ale kontynuuj przetwarzanie wszystkich innych zestawów transakcji.
Zachowaj wymianę — wstrzymywanie wymiany po błędzie Pozostawia wymianę nienaruszoną, tworzy dokument XML dla całej wymiany wsadowej. Zawiesza całą wymianę, gdy co najmniej jeden zestaw transakcji w walidacji wymiany kończy się niepowodzeniem.

Ustawienia wysyłania X12

Zrzut ekranu przedstawiający ustawienia umowy X12 i witryny Azure Portal dla komunikatów wychodzących.

Identifiers

Właściwości opis
ISA1 (kwalifikator autoryzacji) Wartość kwalifikatora autoryzacji, której chcesz użyć. Wartość domyślna to 00 — brak informacji o autoryzacji.

Uwaga: w przypadku wybrania innych wartości określ wartość właściwości ISA2 .
ISA2 Wartość Informacje o autoryzacji do użycia, gdy właściwość ISA1 nie ma wartości 00 — brak informacji o autoryzacji. Ta wartość właściwości musi mieć co najmniej jeden znak alfanumeryczny i maksymalnie 10.
ISA3 (kwalifikator zabezpieczeń) Wartość kwalifikatora zabezpieczeń, której chcesz użyć. Wartość domyślna to 00 — brak informacji zabezpieczających.

Uwaga: w przypadku wybrania innych wartości określ wartość właściwości ISA4 .
ISA4 Wartość Informacje o zabezpieczeniach, która ma być używana, gdy właściwość ISA3 nie ma wartości 00 — brak informacji zabezpieczających. Ta wartość właściwości musi mieć co najmniej jeden znak alfanumeryczny i maksymalnie 10.

Potwierdzenie

Właściwości opis
Oczekiwana ta1 Zwróć potwierdzenie techniczne (TA1) do nadawcy wymiany.

To ustawienie określa, że partner hosta, który wysyła wiadomość, żąda potwierdzenia od partnera gościa w umowie. Te potwierdzenia są oczekiwane przez partnera hosta na podstawie ustawień odbierania umowy.
Oczekiwana fa Zwróć potwierdzenie funkcjonalne (FA) do nadawcy wymiany. Dla właściwości Wersja fa na podstawie wersji schematu wybierz potwierdzenie 997 lub 999.

To ustawienie określa, że partner hosta, który wysyła wiadomość, żąda potwierdzenia od partnera gościa w umowie. Te potwierdzenia są oczekiwane przez partnera hosta na podstawie ustawień odbierania umowy.

Schematy

W tej sekcji wybierz schemat z konta integracji dla każdego typu transakcji (ST01). Po zakończeniu każdego wiersza zostanie automatycznie wyświetlony nowy pusty wiersz.

Właściwości opis
Wersja Wersja X12 dla schematu
Typ transakcji (ST01) Typ transakcji dla schematu
Schemat Plik schematu, którego chcesz użyć. Jeśli najpierw wybierzesz schemat, zostanie automatycznie ustawiona wersja i typ transakcji.

Koperty

Właściwości opis
Użycie isa11 Separator do użycia w zestawie transakcji:

- Identyfikator standardowy: użyj kropki (.) dla notacji dziesiętnej, a nie notacji dziesiętnej dokumentu wychodzącego w potoku wysyłania EDI.

- Separator powtórzeń: określ separator powtarzających się wystąpień prostego elementu danych lub powtarzającej się struktury danych. Na przykład zwykle karat (^) jest używany jako separator powtórzeń. W przypadku schematów HIPAA można używać tylko kareaty.

Numer wersji kontroli

W tej sekcji wybierz schemat z konta integracji dla każdej wymiany. Po zakończeniu każdego wiersza zostanie automatycznie wyświetlony nowy pusty wiersz.

Właściwości opis
Numer wersji kontroli (ISA12) Wersja standardu X12
Wskaźnik użycia (ISA15) Kontekst wymiany, czyli dane testowe, dane informacyjne lub dane produkcyjne
Schemat Schemat używany do generowania segmentów GS i ST dla wymiany zakodowanej w formacie X12, która jest wysyłana do potoku wysyłania EDI.
GS1 Opcjonalnie wybierz kod funkcjonalny.
GS2 Opcjonalnie określ nadawcę aplikacji.
GS3 Opcjonalnie określ odbiornik aplikacji.
GS4 Opcjonalnie wybierz opcję CCYYMMDD lub RRRRDD.
GS5 Opcjonalnie wybierz pozycję HHMM, HHMMSSS lub HHMMSSDd.
GS7 Opcjonalnie wybierz wartość odpowiedzialnej agencji.
GS8 Opcjonalnie określ wersję dokumentu schematu.

Numery kontrolne

Właściwości opis
Numer kontrolny wymiany (ISA13) Zakres wartości dla numeru kontrolnego wymiany, który może mieć wartość minimalną 1 i maksymalną wartość 999999999
Numer kontrolny grupy (GS06) Zakres wartości dla numeru kontrolnego grupy, który może mieć minimalną wartość 1 i maksymalną wartość 999999999
Numer kontrolny zestawu transakcji (ST02) Zakres wartości dla numeru kontrolnego zestawu transakcji, który może mieć minimalną wartość 1 i maksymalną wartość 999999999

- Prefiks: Opcjonalna wartość alfanumeryczna
- Sufiks: opcjonalna wartość alfanumeryczna

Zestawy znaków i separatory

W wierszu Domyślny jest wyświetlany zestaw znaków używany jako ograniczniki schematu komunikatów. Jeśli nie chcesz używać domyślnego zestawu znaków, możesz wprowadzić inny zestaw ograniczników dla każdego typu komunikatu. Po zakończeniu każdego wiersza zostanie automatycznie wyświetlony nowy pusty wiersz.

Napiwek

Aby podać wartości znaków specjalnych, zmodyfikuj umowę w formacie JSON i podaj wartość ASCII dla znaku specjalnego.

Właściwości opis
Zestaw znaków do użycia Zestaw znaków X12, który jest podstawowy, rozszerzony lub UTF8.
Schemat Schemat, którego chcesz użyć. Po wybraniu schematu wybierz zestaw znaków, którego chcesz użyć, na podstawie poniższych opisów separatorów.
Typ danych wejściowych Typ danych wejściowych dla zestawu znaków
Separator składników Pojedynczy znak oddzielający złożone elementy danych
Separator elementów danych Pojedynczy znak oddzielający proste elementy danych w danych złożonych
Separator znaków zastępczych Znak zastępczy, który zastępuje wszystkie znaki separatora w danych ładunku podczas generowania wychodzącego komunikatu X12
Terminator segmentu Pojedynczy znak wskazujący koniec segmentu EDI
Przyrostek Znak do użycia z identyfikatorem segmentu. Jeśli określisz sufiks, element danych terminatora segmentu może być pusty. Jeśli terminator segmentu pozostanie pusty, musisz wyznaczyć sufiks.

Walidacja

W wierszu Domyślny są wyświetlane reguły sprawdzania poprawności, które są używane dla typu komunikatu EDI. Jeśli chcesz zdefiniować różne reguły, zaznacz każde pole, w którym reguła ma mieć wartość true. Po zakończeniu każdego wiersza zostanie automatycznie wyświetlony nowy pusty wiersz.

Właściwości opis
Typ komunikatu Typ komunikatu EDI
Walidacja EDI Przeprowadź walidację EDI dla typów danych zgodnie z definicją właściwości EDI schematu, ograniczeń długości, pustych elementów danych i separatorów końcowych.
Rozszerzona walidacja Jeśli typ danych nie jest EDI, walidacja dotyczy wymagania elementu danych i dozwolonego powtórzenia, wyliczenia i walidacji długości elementu danych (minimalna lub maksymalna).
Zezwalaj na zera wiodące/końcowe Zachowaj wszelkie dodatkowe znaki wiodące lub końcowe zera i spacji. Nie usuwaj tych znaków.
Przycinanie zer wiodących/końcowych Usuń wszystkie znaki wiodące lub końcowe zera i spacji.
Zasady separatora końcowego Generowanie separatorów końcowych.

- Niedozwolone: uniemożliwia ograniczniki końcowe i separatory w wymianie wychodzącej. Jeśli wymiana zawiera ograniczniki końcowe i separatory, wymiana jest zadeklarowana jako nieprawidłowa.

- Opcjonalnie: Wysyłaj wymiany z ogranicznikami i separatorami końcowymi lub bez nich.

- Obowiązkowe: Wymiana wychodząca musi zawierać ograniczniki końcowe i separatory.

Schematy i typy komunikatów HIPAA

Podczas pracy ze schematami HIPAA i typami komunikatów 277 lub 837 należy wykonać kilka dodatkowych kroków. Numery wersji dokumentu (GS8) dla tych typów komunikatów mają więcej niż dziewięć znaków, na przykład "005010X222A1". Ponadto niektóre numery wersji dokumentu mapuje się na typy komunikatów wariantów. Jeśli nie odwołujesz się do poprawnego typu komunikatu w schemacie i w umowie, zostanie wyświetlony następujący komunikat o błędzie:

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

W tej tabeli wymieniono typy komunikatów, których dotyczy problem, wszelkie warianty i numery wersji dokumentu mapujące je na te typy komunikatów:

Typ lub wariant komunikatu opis Numer wersji dokumentu (GS8)
277 Powiadomienie o stanie informacji o o opiece zdrowotnej 005010X212
837_I Instytucjonalne roszczenia o opiekę zdrowotną 004010X096A1
005010X223A1
005010X223A2
837_D Health Care Claim Dental 004010X097A1
005010X224A1
005010X224A2
837_P Health Care Claim Professional 004010X098A1
005010X222
005010X222A1

Należy również wyłączyć walidację EDI podczas korzystania z tych numerów wersji dokumentu, ponieważ powodują one błąd, że długość znaku jest nieprawidłowa.

Aby określić te numery wersji dokumentu i typy komunikatów, wykonaj następujące kroki:

Uwaga

Każdy komunikat z 837_P, 837_I lub typem 837_D wymaga oddzielnej umowy.

  1. W schemacie HIPAA zastąp bieżący typ komunikatu typem komunikatu wariant numer wersji dokumentu, którego chcesz użyć.

    Załóżmy na przykład, że chcesz użyć numeru 005010X222A1 wersji dokumentu z typem komunikatu 837 . W schemacie zastąp każdą "X12_00501_837" wartość wartością "X12_00501_837_P" .

    Aby zaktualizować schemat, wykonaj następujące kroki:

    1. W witrynie Azure Portal przejdź do swojego konta integracji. Znajdź i pobierz schemat. Zastąp typ komunikatu i zmień nazwę pliku schematu, a następnie przekaż poprawiony schemat do konta integracji. Aby uzyskać więcej informacji, zobacz Edytowanie schematu.

    2. W ustawieniach komunikatów umowy wybierz poprawiony schemat.

  2. W obiekcie umowy schemaReferences dodaj kolejny wpis określający typ komunikatu wariantu zgodny z numerem wersji dokumentu.

    Załóżmy na przykład, że chcesz użyć numeru 005010X222A1 wersji dokumentu dla typu komunikatu 837 . Umowa zawiera sekcję zawierającą schemaReferences następujące właściwości i wartości:

    "schemaReferences": [
       {
          "messageId": "837",
          "schemaVersion": "00501",
          "schemaName": "X12_00501_837"
       }
    ]
    

    Edytuj sekcję, schemaReferences aby wyglądać podobnie do poniższego przykładu:

    "schemaReferences": [
       {
          "messageId": "837",
          "schemaVersion": "00501",
          "schemaName": "X12_00501_837_P"
       }
    ]
    
  3. W ustawieniach komunikatów umowy wyłącz walidację EDI, usuwając zaznaczenie pola wyboru Walidacja EDI dla każdego typu komunikatu lub dla wszystkich typów komunikatów, jeśli używasz wartości domyślnych .

    Zrzut ekranu przedstawiający ustawienia umowy X12 umożliwiające wyłączenie walidacji dla wszystkich typów komunikatów lub każdego typu komunikatu.

Następne kroki

Wymiana komunikatów X12