Udostępnij za pośrednictwem

997 potwierdzenia funkcjonalne i kody błędów dla komunikatów X12 w usłudze Azure Logic Apps

  • Artykuł

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

W usłudze Azure Logic Apps można tworzyć przepływy pracy obsługujące komunikaty X12 na potrzeby komunikacji elektronicznej wymiany danych (EDI) podczas korzystania z operacji X12 . W przypadku obsługi komunikatów EDI potwierdzenia zapewniają stan przetwarzania wymiany EDI. Podczas odbierania wymiany akcja dekodowania X12 może zwrócić do nadawcy co najmniej jeden typ potwierdzenia, w zależności od tego, które typy potwierdzenia są włączone i określony poziom weryfikacji.

Na przykład odbiornik zgłasza stan weryfikacji nagłówka grupy funkcjonalnej (GS) i przyczepy grupy funkcjonalnej (GE) w odebranym komunikacie zakodowanym w formacie X12 przez wysłanie potwierdzenia funkcjonalnego 997 (ACK) wraz z każdym błędem, który występuje podczas przetwarzania. Akcja Dekoduj X12 zawsze generuje akcję 997 ACK zgodną ze standardem 4010, podczas gdy zarówno akcja kodowania X12, jak i akcja dekodowania X12 mogą zweryfikować kod 5010 zgodny ze standardem 997 ACK.

Odbiornik wysyła kopertę 997 ACK wewnątrz nagłówka grupy funkcjonalnej (GS) i przyczepy grupy funkcjonalnej (GE). Jednak ta koperta GS i GE nie różni się od innych zestawów transakcji.

Ten temat zawiera krótkie omówienie X12 997 ACK, w tym 997 segmentów ACK w ramach wymiany i kodów błędów używanych w tych segmentach. Aby uzyskać inne powiązane informacje, zapoznaj się z następującą dokumentacją:

997 Segmenty ACK

W poniższej tabeli opisano segmenty 997 ACK w ramach wymiany i używa następujących definicji:

  • M = obowiązkowe
  • O = opcjonalne
Position Identyfikator segmentu Nazwa Wymagane oznaczenie
(Req. Des.)		 Maksymalne użycie Powtarzanie pętli
010 SKLEP Nagłówek zestawu transakcji dla potwierdzenia M 1 -
020 AK1 Nagłówek odpowiedzi grupy funkcjonalnej M 1 -
030 AK2 Nagłówek odpowiedzi zestawu transakcji O 1 999999
(Identyfikator pętli = AK2)
040 AK3 Uwaga dotycząca segmentu danych O 1 999999
(Identyfikator pętli = AK2 lub AK3)
050 AK4 Uwaga dotycząca elementu danych O 9 9 -
060 AK5 Zwiastun odpowiedzi zestawu transakcji M 1 -
070 AK9 Przyczepa odpowiedzi grupy funkcjonalnej M 1 -
080 SE Zwiastun zestawu transakcji dla potwierdzenia M 1 -

Poniższe sekcje zawierają więcej informacji o poszczególnych segmentach ak. W pętli AK2 do AK5 segmenty zawierają informacje o błędzie z zestawem transakcji.

AK1

Obowiązkowy segment AK1 identyfikuje grupę funkcjonalną do potwierdzenia przy użyciu następujących elementów danych:

Element Opis
AK101 Obowiązkowy, identyfikuje identyfikator grupy funkcjonalnej (GS01) dla grupy funkcjonalnej do potwierdzenia.
AK102 Obowiązkowy, identyfikuje numer kontrolny grupy (GS06 i GE02), aby grupa funkcjonalna przyznała.
AK103 Opcjonalnie identyfikuje wersję implementacji EDI wysłaną w GS08 z oryginalnej transakcji. Aplikacja AK103 obsługuje ruch przychodzący 5010 zgodny ze standardem 997 ACK.

AK2

Opcjonalny segment AK2 zawiera potwierdzenie transakcji ustawionej w odebranej grupie funkcjonalnej. Jeśli istnieje wiele segmentów AK2, są one wysyłane jako seria pętli. Każda pętla AK2 identyfikuje zestaw transakcji przy użyciu odebranego zamówienia. Jeśli zestaw transakcji jest w błędzie, pętla AK2 zawiera segmenty AK3, AK4 i AK5. Aby uzyskać więcej informacji, zapoznaj się z opisami segmentów w dalszej części tego tematu.

Segment AK2 identyfikuje zestaw transakcji przy użyciu następujących elementów danych:

Element Opis
AK201 Obowiązkowy, identyfikuje identyfikator zestawu transakcji (ST01) transakcji ustawionej na potwierdzenie.
AK202 Obowiązkowy, identyfikuje numer kontrolny zestawu transakcji (ST02 i SE02) transakcji ustawionej na potwierdzenie.
AK203 Opcjonalnie identyfikuje wersję implementacji EDI wysłaną w st03 oryginalnej transakcji. Aplikacja AK203 obsługuje ruch przychodzący zgodny ze standardem 5010 997.

Generowanie segmentów AK2

Można określić, że segmenty AK2 są generowane dla wszystkich akceptowanych i odrzuconych zestawów transakcji lub tylko dla odrzuconych zestawów transakcji. W przeciwnym razie usługa Azure Logic Apps generuje pętle AK2 tylko dla odrzuconych zestawów transakcji. Jeśli umowa nie rozwiąże problemu z odpowiedzią na wymianę, ustawienia 997 generacji są domyślne dla ustawień umowy rezerwowej, a segmenty AK2 nie są generowane dla akceptowanych zestawów transakcji.

Aby usługa Azure Logic Apps wygenerowała segmenty AK2 dla akceptowanych zestawów transakcji, w których AK501 == A, wykonaj następujące kroki:

  1. W Azure Portal otwórz konto integracji, a następnie otwórz artefakt umowy X12 między partnerami handlowymi X12.

  2. Otwórz okienko Ustawienia odbierania , upewnij się, że wybrano opcję Oczekiwano fa . Następnie możesz wybrać opcję Uwzględnij pętlę AK2 /IK2.

AK3

Opcjonalny segment AK3 zgłasza błędy w segmencie danych i identyfikuje lokalizację segmentu danych. Segment AK3 jest tworzony dla każdego segmentu w zestawie transakcji, który zawiera co najmniej jeden błąd. Jeśli istnieje wiele segmentów AK3, są one wysyłane jako seria pętli z jednym segmentem na pętlę. Segment AK3 określa lokalizację każdego segmentu w błędzie i zgłasza typ błędu składniowego znalezionego w tej lokalizacji przy użyciu następujących elementów danych:

Element Opis
AK301 Obowiązkowy, identyfikuje segment w błędzie z identyfikatorem segmentu X12, na przykład NM1.
AK302 Obowiązkowy, identyfikuje liczbę segmentów segmentu w błędzie. Segment st to 1, a każdy segment zwiększa liczbę segmentów o jeden.
AK303 Obowiązkowy, identyfikuje powiązaną pętlę, która jest pętlą otoczoną segmentem startu pętli (LS) i segmentem sprzężenia końcowego (LE). AK303 zawiera wartości segmentów LS i LE, które powiązały segment w błędzie.
AK304 Opcjonalnie określa kod błędu w segmencie danych. Mimo że ak304 jest opcjonalny, element jest wymagany, gdy istnieje błąd dla zidentyfikowanego segmentu. W przypadku kodów błędów AK304 przejrzyj kody błędów 997 ACK — uwaga dotycząca segmentu danych.

AK4

Opcjonalny segment AK4 zgłasza błędy w elemecie danych lub strukturze danych złożonych oraz identyfikuje lokalizację elementu danych. Segment AK4 jest wysyłany, gdy element danych AK304 jest "8", "Segment has data element errors" i może powtarzać się do 99 razy w każdym segmencie AK3. Segment AK4 określa lokalizację każdego elementu danych lub złożonej struktury danych w błędzie i zgłasza typ błędu składniowego znalezionego w tej lokalizacji przy użyciu następujących elementów danych:

Element Opis
AK401 Obowiązkowy element danych złożonych z następującymi polami: AK41.1, AK41.2 i AK41.3

- AK401.1: Identyfikuje element danych lub złożoną strukturę danych w błędzie przy użyciu liczby liczbowej. Jeśli na przykład drugi element danych w segmencie zawiera błąd, ak401 to 2.
AK401.2: Identyfikuje liczbę liczbową elementu danych składnika w złożonej strukturze danych, która zawiera błąd. Gdy ak401 zgłasza błąd w strukturze danych, która nie jest złożona, ak401.2 nie jest wartością.
- AK41.3: Opcjonalne, to pole jest powtarzającym się położeniem elementu danych. Aplikacja AK41.3 obsługuje przychodzące 5010 zgodne ze standardem 997.
AK402 Opcjonalnie identyfikuje prosty numer elementu danych X12 w błędzie. Na przykład NM101 to prosty element danych X12 numer 98.
AK403 Obowiązkowe— zgłasza błąd zidentyfikowanego elementu. W przypadku kodów błędów AK403 przejrzyj kody błędów 997 ACK — uwaga dotycząca elementu danych.
AK404 Opcjonalnie zawiera kopię zidentyfikowanego elementu danych w błędzie. Ak404 nie jest używany, jeśli błąd wskazuje nieprawidłowy znak.

AK5

Segment AK5 zgłasza, czy zestaw transakcji zidentyfikowany w segmencie AK2 jest akceptowany, czy odrzucany i dlaczego. Segment AK5 jest obowiązkowy, gdy opcjonalna pętla AK2 jest uwzględniona w potwierdzeniu. Segment AK4 określa stan zestawu transakcji przy użyciu jednego obowiązkowego elementu danych i udostępnia kody błędów przy użyciu od jednego do pięciu opcjonalnych elementów danych na podstawie edytowania składni zestawu transakcji.

Element Opis
AK501 Obowiązkowy określa, czy zidentyfikowany zestaw transakcji jest akceptowany, czy odrzucany. W przypadku kodów błędów AK501 przejrzyj kody błędów 997 ACK — Zwiastun odpowiedzi transakcji.
AK502 — AK506 Opcjonalnie określ charakter błędu. W przypadku kodów błędów AK502 zapoznaj się z kodami błędów 997 ACK — Zwiastun odpowiedzi zestawu transakcji.

AK9

Obowiązkowy segment AK9 wskazuje, czy grupa funkcjonalna zidentyfikowana w segmencie AK1 jest akceptowana, czy odrzucana i dlaczego. Segment AK9 określa stan zestawu transakcji i charakter dowolnego błędu przy użyciu czterech obowiązkowych elementów danych. Segment określa wszelkie zanotowane błędy przy użyciu od jednego do pięciu elementów opcjonalnych.

Element Opis
AK901 Obowiązkowe określa, czy grupa funkcjonalna zidentyfikowana w ak1 jest akceptowana, czy odrzucana. W przypadku kodów błędów AK901 przejrzyj kody błędów 997 ACK — funkcjonalna przyczepa odpowiedzi grupy.
AK902 Obowiązkowy, określa liczbę zestawów transakcji uwzględnionych w zidentyfikowanej przyczepie grupy funkcjonalnej (GE01).
AK903 Obowiązkowy, określa liczbę odebranych zestawów transakcji.
AK904 Obowiązkowe określa liczbę zestawów transakcji akceptowanych w zidentyfikowanej grupie funkcjonalnej.
AK905 - AK909 Opcjonalnie wskazuje od jednego do pięciu błędów zanotowany w zidentyfikowanej grupie funkcjonalnej. Aby uzyskać kody błędów OD AK905 do AK909, zapoznaj się z kodami błędów 997 ACK — funkcjonalna przyczepa odpowiedzi grupy funkcjonalnej.

Kody błędów 997 ACK

W tej sekcji opisano kody błędów używane w segmentach ACK 997. Każda tabela zawiera listę obsługiwanych i nieobsługiwanych kodów błędów zdefiniowanych w specyfikacji X12 na potrzeby przetwarzania komunikatów X12 w usłudze Azure Logic Apps.

Kody błędów AK304 — uwaga dotycząca segmentu danych

W poniższej tabeli wymieniono kody błędów używane w elemecie danych AK304 segmentu AK3 (Uwaga dotycząca segmentu danych):

Kod błędu Warunek Obsługiwane?
1 Nierozpoznany identyfikator segmentu Tak
2 Nieoczekiwany segment Tak
3 Brak obowiązkowego segmentu Tak
4 Pętla występuje w maksymalnym czasie Tak
5 Segment przekracza maksymalne użycie Tak
6 Segment nie jest w zdefiniowanym zestawie transakcji Tak
7 Segment nie jest w odpowiedniej kolejności Tak
8 Segment zawiera błędy elementów danych Tak
511 Napotkano separatory końcowe (kod niestandardowy) Tak

Kody błędów AK403 — uwaga dotycząca elementu danych

W poniższej tabeli wymieniono kody błędów używane w elemecie danych AK403 segmentu AK4 (Uwaga dotycząca elementu danych):

Kod błędu Warunek Obsługiwane?
1 Brak obowiązkowego elementu danych Tak
2 Brak warunkowego wymaganego elementu danych Tak
3 Zbyt wiele elementów danych Tak
4 Element danych jest za krótki Tak
5 Element danych jest za długi Tak
6 Nieprawidłowy znak w elemecie danych Tak
7 Nieprawidłowa wartość kodu Tak
8 Nieprawidłowa data Tak
9 Nieprawidłowy czas Tak
10 Naruszono warunek wykluczenia Tak

Kody błędów AK501 — przyczepa odpowiedzi zestawu transakcji

W poniższej tabeli wymieniono kody błędów używane w elemecie danych AK501 segmentu AK5 (Przyczepa odpowiedzi zestawu transakcji):

Kod błędu Warunek Obsługiwane?
A Zaakceptowano Tak
E Zaakceptowane, ale zanotowano błędy Tak

Uwaga: kody błędów nie prowadzą do stanu E.
M Odrzucono kod uwierzytelniania komunikatów (MAC) nie powiodło się Nie
P Częściowo zaakceptowano co najmniej jeden zestaw transakcji został odrzucony Tak
R Odrzucone Tak
W Odrzucone, test poprawności nie powiodło się Nie
X Odrzucono zawartość po odszyfrowaniu nie można przeanalizować Nie

Kody błędów AK502 do AK506 — przyczepa odpowiedzi zestawu transakcji

W poniższej tabeli wymieniono kody błędów używane w ak502 do elementów danych AK506 segmentu AK5 (Przyczepa odpowiedzi zestawu transakcji):

Kod błędu Warunek Obsługiwane lub
skorelowany z AK501?
1 Zestaw transakcji nie jest obsługiwany Tak, R
2 Brak przyczepy zestawu transakcji Tak, R
3 Numer kontrolny zestawu transakcji w nagłówku i przyczepie nie jest zgodny Tak, R
4 Liczba uwzględnionych segmentów nie jest zgodna z rzeczywistą liczbą Tak, R
5 Jeden lub więcej segmentów w błędzie Tak, R
6 Brak lub nieprawidłowy identyfikator zestawu transakcji Tak, R
7 Brak lub nieprawidłowy numer kontrolny zestawu transakcji, mógł wystąpić zduplikowany numer transakcji Tak, R
Od 8 do 27 - Nie

Kody błędów AK901 — przyczepa odpowiedzi grupy funkcjonalnej

W poniższej tabeli wymieniono kody błędów używane w elementach danych AK901 segmentu AK9 (przyczepa odpowiedzi grupy funkcjonalnej):

Kod błędu Warunek Obsługiwane lub
skorelowany z AK501?
A Zaakceptowano Tak
E Zaakceptowano, ale zanotowano błędy Tak
M Odrzucono, kod uwierzytelniania komunikatu (MAC) nie powiódł się Nie
P Częściowo zaakceptowano, co najmniej jeden zestaw transakcji został odrzucony Tak
R Odrzucone Tak
W Odrzucone, sprawdzanie poprawności zakończone niepowodzeniem Nie
X Odrzucono, nie można przeanalizować zawartości po odszyfrowaniu Nie

Kody błędów AK905 do AK909 — przyczepa odpowiedzi grupy funkcjonalnej

W poniższej tabeli wymieniono kody błędów używane w ak905 do ak909 elementów danych segmentu AK9 (funkcjonalna grupa odpowiedzi przyczepy):

Kod błędu Warunek Obsługiwane lub
skorelowany z AK501?
1 Grupa funkcjonalna nie jest obsługiwana Nie
2 Wersja grupy funkcjonalnej nie jest obsługiwana Nie
3 Brak przyczepy grupy funkcjonalnej Tak
4 Numer kontrolny grupy w nagłówku grupy funkcjonalnej i przyczepie nie zgadzają się Tak
5 Liczba uwzględnionych zestawów transakcji nie jest zgodna z rzeczywistą liczbą Tak
6 Numer kontrolny grupy narusza składnię, mógł wystąpić zduplikowany numer kontrolny grupy Tak
Od 7 do 26 - Nie

Następne kroki