Sdílet prostřednictvím

997 – potvrzení funkčnosti a kódy chyb pro zprávy X12 v Azure Logic Apps

  • Článek

Platí pro: Azure Logic Apps (Consumption + Standard)

V Azure Logic Apps můžete vytvářet pracovní postupy, které zpracovávají zprávy X12 pro komunikaci EDI (Electronic Data Interchange), když používáte operace X12 . V zasílání zpráv EDI potvrzení poskytují stav zpracování výměny EDI. Při přijetí výměny může akce Dekódování X12 vrátit odesílateli jeden nebo více typů potvrzení na základě toho, jaké typy potvrzení jsou povoleny a zadaná úroveň ověření.

Příjemce například ohlásí stav ověření hlavičky funkční skupiny (GS) a upoutávky funkční skupiny (GE) v přijaté zprávě s kódováním X12 odesláním 997 funkčního potvrzení (ACK) spolu s každou chybou, ke které dojde během zpracování. Akce dekódování X12 vždy vygeneruje 997 ACK kompatibilní se standardem 4010, zatímco akce Kódování X12 i akce Dekódování X12 mohou ověřit ACK 997 kompatibilní s 5010.

Příjemce odešle ACK 997 uvnitř hlavičky funkční skupiny (GS) a funkční skupiny přívěsu (GE). Tato obálka GS a GE se však neliší od jakékoli jiné sady transakcí.

Toto téma poskytuje stručný přehled O X12 997 ACK, včetně segmentů ACK 997 ve výměně a kódů chyb používaných v těchto segmentech. Další související informace najdete v následující dokumentaci:

997 Segmenty ACK

Následující tabulka popisuje segmenty ACK 997 ve výměně a používá následující definice:

  • M = povinné
  • O = volitelné
Position ID segmentu Name Požadované označení
(Req. Des.)		 Maximální využití Opakování smyčky
010 ST Hlavička sady transakcí pro potvrzení M 1 -
020 AK1 Hlavička odpovědi funkční skupiny M 1 -
030 AK2 Hlavička odpovědi sady transakcí O 1 999999
(ID smyčky = AK2)
040 AK3 Poznámka k datovému segmentu O 1 999999
(ID smyčky = AK2 nebo AK3)
050 AK4 Poznámka k datovému prvku O 9 9 -
060 AK5 Upoutávka odpovědí na sadu transakcí M 1 -
070 AK9 Upoutávka k funkční skupině odpovědí M 1 -
080 SE Trailer sady transakcí pro potvrzení M 1 -

Další informace o jednotlivých segmentech AK najdete v následujících částech. Ve smyčce AK2 až AK5 segmenty poskytují informace o chybě se sadou transakcí.

AK1

Povinný segment AK1 identifikuje funkční skupinu, kterou chcete potvrdit, pomocí následujících datových prvků:

Element Popis
AK101 Povinný, identifikuje ID funkční skupiny (GS01), které má funkční skupina potvrdit.
AK102 Povinné, určuje kontrolní číslo skupiny (GS06 a GE02), aby funkční skupina byla potvrzena.
AK103 Volitelné, identifikuje verzi implementace EDI odeslanou v GS08 z původní transakce. AK103 podporuje příchozí 997 ACK kompatibilní s 5010.

AK2

Volitelný segment AK2 obsahuje potvrzení pro sadu transakcí v přijaté funkční skupině. Pokud existuje více segmentů AK2, odesílají se jako řada smyček. Každá smyčka AK2 identifikuje sadu transakcí pomocí přijaté objednávky. Pokud je sada transakcí chybná, smyčka AK2 obsahuje segmenty AK3, AK4 a AK5. Další informace najdete v popisech segmentů dále v tomto tématu.

Segment AK2 identifikuje sadu transakcí pomocí následujících datových prvků:

Element Popis
AK201 Povinné, identifikuje ID sady transakcí (ST01) sady transakcí k potvrzení.
AK202 Povinný, identifikuje kontrolní číslo sady transakcí (ST02 a SE02) sady transakcí k potvrzení.
AK203 Volitelné, identifikuje verzi implementace EDI odeslanou v ST03 původní transakce. AK203 podporuje příchozí protokol 997 kompatibilní se standardem 5010.

Generování segmentů AK2

Můžete určit, že segmenty AK2 jsou generovány pro všechny přijaté a odmítnuté sady transakcí, nebo pouze pro odmítnuté sady transakcí. V opačném případě Azure Logic Apps generuje smyčky AK2 pouze pro odmítnuté sady transakcí. Pokud se smlouva nevyřeší pro výměnu, na kterou se odpovídá, nastavení generování 997 ve výchozím nastavení záložní smlouvy a segmenty AK2 se negenerují pro akceptované sady transakcí.

Pokud chcete, aby Služba Azure Logic Apps generovala segmenty AK2 pro akceptované sady transakcí, kde AK501 == A, postupujte takto:

  1. V Azure Portal otevřete svůj účet integrace a pak otevřete artefakt smlouvy X12 mezi obchodními partnery X12.

  2. Otevřete podokno Nastavení příjmu a ujistěte se, že je vybraná možnost FA Expected (Očekávaná možnost FA ). Pak můžete vybrat Zahrnout smyčku AK2/IK2.

AK3

Volitelný segment AK3 hlásí chyby v datovém segmentu a identifikuje umístění datového segmentu. Segment AK3 se vytvoří pro každý segment v sadě transakcí, který obsahuje jednu nebo více chyb. Pokud existuje více segmentů AK3, odesílají se jako řada smyček s jedním segmentem na každou smyčku. Segment AK3 určuje umístění jednotlivých segmentů v chybě a hlásí typ syntaktické chyby nalezené v tomto umístění pomocí následujících datových prvků:

Element Popis
AK301 Povinný parametr identifikuje chybový segment pomocí ID segmentu X12, například NM1.
AK302 Povinný parametr identifikuje počet segmentů v chybovém segmentu. Segment ST je 1a každý segment navyšuje počet segmentů o jeden.
AK303 Povinný parametr identifikuje ohraničenou smyčku, což je smyčka uzavřená segmentem Spuštění smyčky (LS) a segmentem Konec smyčky (LE). AK303 obsahuje hodnoty LS a LE segmentů, které vázaly segment v chybě.
AK304 Volitelné: Určuje kód chyby v datovém segmentu. I když je AK304 volitelný, element se vyžaduje, pokud pro identifikovaný segment existuje chyba. Informace o kódech chyb AK304 najdete v tématu Kódy chyb ACK 997 – poznámka k datovému segmentu.

AK4

Volitelný segment AK4 hlásí chyby v datovém prvku nebo složené datové struktuře a identifikuje umístění datového prvku. Segment AK4 se odešle, když je "8", "Segment has data element errors" datový prvek AK304 a může se v každém segmentu AK3 opakovat až 99krát. Segment AK4 určuje umístění každého datového prvku nebo složené datové struktury v chybě a hlásí typ syntaktické chyby nalezené v tomto umístění pomocí následujících datových prvků:

Element Popis
AK401 Povinný– složený datový prvek s následujícími poli: AK41.1, AK41.2 a AK41.3

– AK401.1: Identifikuje chybný datový prvek nebo složenou datovou strukturu pomocí jeho číselného počtu. Pokud má například druhý datový prvek v segmentu chybu, AK401 se 2rovná .
AK401.2: Identifikuje číselný počet komponentního datového prvku ve složené datové struktuře, který obsahuje chybu. Když AK401 hlásí chybu u datové struktury, která není složená, hodnota AK401.2 není.
– AK41.3: Volitelné. Toto pole je pozice opakujícího se datového prvku. AK41.3 podporuje příchozí protokol 5010 kompatibilní s 997.
AK402 Nepovinný parametr identifikuje jednoduché číslo datového prvku X12 prvku v chybě. Například NM101 je jednoduchý datový prvek X12 s číslem 98.
AK403 Povinné, hlásí chybu identifikovaného prvku. Informace o kódech chyb AK403 najdete v tématu Kódy chyb ACK 997 – Poznámka k datovým prvkům.
AK404 Volitelné – obsahuje kopii identifikovaného datového prvku v chybě. AK404 se nepoužívá, pokud chyba značí neplatný znak.

AK5

Segment AK5 hlásí, jestli je sada transakcí identifikovaná v segmentu AK2 přijata nebo odmítnuta a proč. Segment AK5 je povinný, pokud je volitelná smyčka AK2 součástí potvrzení. Segment AK4 určuje stav sady transakcí pomocí jednoho povinného datového prvku a poskytuje kódy chyb pomocí jednoho až pěti volitelných datových prvků na základě úpravy syntaxe sady transakcí.

Element Popis
AK501 Povinný, určuje, zda je identifikovaná sada transakcí přijata nebo odmítnuta. Kódy chyb AK501 najdete v tématu Kódy chyb ACK 997 – Transaction Response Trailer.
AK502 – AK506 Volitelné– označuje povahu chyby. Informace o kódech chyb AK502 najdete v tématu Kódy chyb ACK 997 – Transaction Set Response Trailer.

AK9

Povinný segment AK9 označuje, jestli je funkční skupina identifikovaná v segmentu AK1 přijata nebo odmítnuta a proč. Segment AK9 určuje stav sady transakcí a povahu jakékoli chyby pomocí čtyř povinných datových prvků. Segment určuje všechny zaznamenané chyby pomocí jednoho až pěti volitelných prvků.

Element Popis
AK901 Povinné– určuje, jestli je funkční skupina identifikovaná v AK1 přijata nebo odmítnuta. Informace o kódech chyb AK901 najdete v tématu Kódy chyb ACK 997 – Trailer odpovědi funkční skupiny.
AK902 Povinné, určuje počet sad transakcí zahrnutých v identifikované funkční skupině (GE01).
AK903 Povinný, určuje počet přijatých sad transakcí.
AK904 Povinný, určuje počet sad transakcí přijatých v identifikované funkční skupině.
AK905 – AK909 Volitelné: Označuje jednu až pět chyb zjištěných v identifikované funkční skupině. Informace o kódech chyb AK905 až AK909 najdete v tématu Kódy chyb ACK 997 – Upoutávka odpovědí funkční skupiny.

Kódy chyb ACK 997

Tato část popisuje kódy chyb používané v segmentech ACK 997. Každá tabulka uvádí podporované a nepodporované kódy chyb definované specifikací X12 pro zpracování zpráv X12 v Azure Logic Apps.

Kódy chyb AK304 – poznámka k datovému segmentu

Následující tabulka uvádí kódy chyb použité v datovém prvku AK304 segmentu AK3 (poznámka k datovému segmentu):

Kód chyby Podmínka Podporované?
1 Nerozpoznané ID segmentu Yes
2 Neočekávaný segment Yes
3 Chybí povinný segment. Yes
4 Smyčka probíhá v maximálním čase Yes
5 Segment překračuje maximální využití Yes
6 Segment není v definované sadě transakcí Yes
7 Segment není ve správném pořadí Yes
8 Segment obsahuje chyby datových prvků Yes
511 Nalezené koncové oddělovače (vlastní kód) Yes

Kódy chyb AK403 – poznámka k datovému prvku

Následující tabulka uvádí kódy chyb použité v datovém prvku AK403 segmentu AK4 (poznámka k datovému prvku):

Kód chyby Podmínka Podporované?
1 Chybí povinný datový prvek. Yes
2 Chybí podmíněný požadovaný datový prvek. Yes
3 Příliš mnoho datových prvků Yes
4 Datový prvek je příliš krátký. Yes
5 Datový prvek je příliš dlouhý. Yes
6 Neplatný znak v datovém prvku Yes
7 Neplatná hodnota kódu Yes
8 Neplatné datum Yes
9 Neplatný čas Yes
10 Porušení podmínky vyloučení Yes

Kódy chyb AK501 – Upoutávka odpovědí na sadu transakcí

Následující tabulka uvádí kódy chyb použité v datovém prvku AK501 segmentu AK5 (upoutávka odpovědí sady transakcí):

Kód chyby Podmínka Podporované?
A Přijato Yes
E Přijato, ale byly zaznamenány chyby Yes

Poznámka: Žádné kódy chyb nevedou ke stavu E.
M Odmítnuto, ověřovací kód zpráv (MAC) selhal No
P Částečně přijato, nejméně jedna sada transakcí byla odmítnuta Yes
R Zamítnuto Yes
W Zamítnuto, testy platnosti ověření selhaly No
× Odmítnuto, obsah po dešifrování nelze analyzovat No

Kódy chyb AK502 až AK506 – Upoutávka odpovědí sady transakcí

Následující tabulka uvádí kódy chyb použité v datových prvech AK502 až AK506 segmentu AK5 (upoutávka odpovědi sady transakcí):

Kód chyby Podmínka Podporované nebo
korelaci s AK501?
1 Sada transakcí se nepodporuje. Ano, R
2 Chybí upoutávka sady transakcí Ano, R
3 Kontrolní číslo sady transakcí v hlavičce a přívěsu se neshoduje Ano, R
4 Počet zahrnutých segmentů neodpovídá skutečnému počtu Ano, R
5 Jeden nebo více segmentů, u které došlo k chybě Ano, R
6 Chybějící nebo neplatný identifikátor sady transakcí Ano, R
7 Chybějící nebo neplatné kontrolní číslo sady transakcí, mohlo dojít k duplicitnímu číslu transakce. Ano, R
8 až 27 - No

Kódy chyb AK901 – Upoutávka odpovědí na funkční skupinu

Následující tabulka uvádí kódy chyb použité v datových prvek AK901 segmentu AK9 (upoutávka odpovědí funkční skupiny):

Kód chyby Podmínka Podporováno nebo
koreluje s AK501?
A Přijato Yes
E Přijato, ale byly zaznamenány chyby Yes
M Odmítnuto, ověřovací kód zprávy (MAC) selhal No
P Částečně přijato, nejméně jedna sada transakcí byla odmítnuta Yes
R Zamítnuto Yes
W Zamítnuto, testy platnosti ověření selhaly No
× Odmítnuto, obsah po dešifrování nelze analyzovat No

Kódy chyb AK905 až AK909 – Upoutávka odpovědí funkční skupiny

Následující tabulka uvádí kódy chyb použité v datových prvčtech AK905 až AK909 segmentu AK9 (upoutávka odpovědí funkční skupiny):

Kód chyby Podmínka Podporováno nebo
koreluje s AK501?
1 Funkční skupina se nepodporuje. No
2 Verze funkční skupiny se nepodporuje. No
3 Chybí upoutávka funkční skupiny Yes
4 Kontrolní číslo skupiny v záhlaví funkční skupiny a přívěsu nesouhlasí Yes
5 Počet zahrnutých sad transakcí neodpovídá skutečnému počtu Yes
6 Řídicí číslo skupiny porušuje syntaxi, mohlo dojít k duplicitnímu kontrolnímu číslu skupiny. Yes
7 až 26 - No

Další kroky