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
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
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.
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 komunikatu837
. W schemacie zastąp każdą"X12_00501_837"
wartość wartością"X12_00501_837_P"
.Aby zaktualizować schemat, wykonaj następujące kroki:
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.
W ustawieniach komunikatów umowy wybierz poprawiony schemat.
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 komunikatu837
. 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" } ]
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 .