997 potwierdzenia funkcjonalne i kody błędów dla komunikatów X12 w usłudze Azure Logic Apps
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ć co najmniej jeden typ potwierdzenia do nadawcy, 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 dekodowania X12 zawsze generuje akcję 997 ACK zgodną ze standardem 4010, podczas gdy zarówno akcja kodowania X12, jak i akcja dekodowania X12 może 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 żadnego innego zestawu transakcji.
Ten temat zawiera krótkie omówienie X12 997 ACK, w tym 997 segmentów ACK w wymiennych i kodów błędów używanych w tych segmentach. Aby uzyskać inne powiązane informacje, zapoznaj się z następującą dokumentacją:
- Potwierdzenia techniczne i kody błędów X12 TA1
- Komunikaty X12 programu Exchange na potrzeby integracji B2B enterprise
- Exchange EDIFACT messages for B2B enterprise integration (Wymiana komunikatów EDIFACT na potrzeby integracji przedsiębiorstwa B2B)
- Co to jest usługa Azure Logic Apps
- Rozwiązania integracyjne B2B dla przedsiębiorstw z usługami Azure Logic Apps i Enterprise Integration Pack
997 Segmenty ACK
W poniższej tabeli opisano segmenty 997 ACK w wymiennej i są używane następujące definicje:
- M = obowiązkowe
- O = opcjonalnie
| Position | Identyfikator segmentu | Nazwisko | 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 | Zestaw transakcji — zwiastun 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ązkowe, identyfikuje identyfikator grupy funkcjonalnej (GS01) dla grupy funkcjonalnej do potwierdzenia. |
| AK102 | Obowiązkowe, identyfikuje numer kontrolny grupy (GS06 i GE02) dla grupy funkcjonalnej do potwierdzenia. |
| AK103 | Opcjonalnie identyfikuje wersję implementacji EDI wysłaną w GS08 z oryginalnej transakcji. Aplikacja AK103 obsługuje przychodzący 5010 zgodny z protokołem 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ązkowe, identyfikuje identyfikator zestawu transakcji (ST01) transakcji ustawionej na potwierdzenie. |
| AK202 | Obowiązkowe, 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 generacji 997 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:
W witrynie Azure Portal otwórz konto integracji, a następnie otwórz artefakt umowy X12 między partnerami handlowymi X12.
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ązkowe, 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 końca pętli (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 zapoznaj się z artykułem 997 Kody błędów 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ązkowe, złożony element danych 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 liczb liczbowych. Jeśli na przykład drugi element danych w segmencie zawiera błąd, wartość AK401 jest |
| 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 zapoznaj się z kodem 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 zawarta 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 zapoznaj się z kodem błędów 997 ACK — Transaction Response Trailer. |
| AK502 — AK506 | Opcjonalnie określ charakter błędu. W przypadku kodów błędów AK502 zapoznaj się z kodem błędów 997 ACK — Zestaw transakcji Trailer odpowiedzi. |
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 opcjonalnych elementów.
| 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 zapoznaj się z kodem błędów 997 ACK — funkcjonalna odpowiedź grupy przyczepy. |
| 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ązkowy, 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. W przypadku kodów błędów 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 | Stan | Obsługiwane? |
|---|---|---|
| 1 | Nierozpoznany identyfikator segmentu | Tak |
| 2 | Nieoczekiwany segment | Tak |
| 3 | Brak obowiązkowego segmentu | Tak |
| 100 | Pętla występuje w ciągu maksymalnego czasu | Tak |
| 5 | Segment przekracza maksymalne użycie | Tak |
| 6 | Segment nie w zdefiniowanym zestawie transakcji | Tak |
| 7 | Segment nie jest w odpowiedniej sekwencji | 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 | Stan | Obsługiwane? |
|---|---|---|
| 1 | Brak obowiązkowego elementu danych | Tak |
| 2 | Brak warunkowego wymaganego elementu danych | Tak |
| 3 | Zbyt wiele elementów danych | Tak |
| 100 | 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 — zwiastun odpowiedzi zestawu transakcji
W poniższej tabeli wymieniono kody błędów używane w elemecie danych AK501 segmentu AK5 (Transaction Set Response Trailer):
| Kod błędu | Stan | Obsługiwane? |
|---|---|---|
| A | Zaakceptowano | Tak |
| E | Zaakceptowane, ale zanotowano błędy | Tak
Uwaga: Żadne kody błędów nie prowadzą do stanu |
| M | Odrzucono, kod uwierzytelniania komunikatu (MAC) zakończył się niepowodzeniem | Nie. |
| P | Częściowo zaakceptowano, co najmniej jeden zestaw transakcji został odrzucony | Tak |
| R | Odrzucona | Tak |
| Ś | Odrzucone, testy poprawności nie powiodły się | Nie. |
| X | Odrzucono zawartość po odszyfrowaniu nie można przeanalizować | Nie. |
Kody błędów AK502 do AK506 — zwiastun odpowiedzi zestawu transakcji
W poniższej tabeli wymieniono kody błędów używane w ak502 do AK506 elementów danych segmentu AK5 (Transaction Set Response Trailer):
| Kod błędu | Stan | Obsługiwane lub skorelowane 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 |
| 100 | Liczba uwzględnionych segmentów nie jest zgodna z rzeczywistą liczbą | Tak, R |
| 5 | Co najmniej jeden segment błędu | 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 (odpowiedź grupy funkcjonalnej):
| Kod błędu | Stan | Obsługiwane lub skorelowane z AK501? |
|---|---|---|
| A | Zaakceptowano | Tak |
| E | Zaakceptowane, ale zanotowano błędy | Tak |
| M | Odrzucono, kod uwierzytelniania komunikatu (MAC) zakończył się niepowodzeniem | Nie. |
| P | Częściowo zaakceptowano, co najmniej jeden zestaw transakcji został odrzucony | Tak |
| R | Odrzucona | Tak |
| Ś | Odrzucone, testy poprawności nie powiodły się | Nie. |
| X | Odrzucono zawartość po odszyfrowaniu nie można przeanalizować | 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 (funkcjonalny zwiastun odpowiedzi grupy funkcjonalnej):
| Kod błędu | Stan | Obsługiwane lub skorelowane 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 |
| 100 | Numer kontrolny grupy w nagłówku grupy funkcjonalnej i przyczepy nie zgadzają się | Tak |
| 5 | Liczba dołączonych 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. |