997 funktionella bekräftelser och felkoder för X12-meddelanden i Azure Logic Apps
Gäller för: Azure Logic Apps (Förbrukning + Standard)
I Azure Logic Apps kan du skapa arbetsflöden som hanterar X12-meddelanden för EDI-kommunikation (Electronic Data Interchange) när du använder X12-åtgärder . I EDI-meddelanden ger bekräftelser statusen från bearbetning av ett EDI-utbyte. När du tar emot ett utbyte kan X12-avkodningsåtgärden returnera en eller flera typer av bekräftelser till avsändaren, baserat på vilka bekräftelsetyper som är aktiverade och den angivna valideringsnivån.
Mottagaren rapporterar till exempel statusen från valideringen av funktionell grupprubrik (GS) och funktionell grupptrailer (GE) i det mottagna X12-kodade meddelandet genom att skicka en 997-funktionsbekräftelse (ACK) tillsammans med varje fel som inträffar under bearbetningen. X12-avkodningsåtgärden genererar alltid en 4010-kompatibel 997 ACK, medan både X12-kodningsåtgärdenoch X12-avkodningsåtgärden kan verifiera en 5010-kompatibel 997 ACK.
Mottagaren skickar 997 ACK inuti ett GS-kuvert (Functional Group Header) och Functional Group Trailer (GE). Det här GS- och GE-kuvertet skiljer sig dock inte från andra transaktionsuppsättningar.
Det här avsnittet innehåller en kort översikt över X12 997 ACK, inklusive 997 ACK-segmenten i ett utbyte och de felkoder som används i dessa segment. Mer relaterad information finns i följande dokumentation:
- Tekniska X12 TA1-bekräftelser och felkoder
- Exchange X12-meddelanden för B2B-företagsintegrering
- Exchange EDIFACT-meddelanden för B2B-företagsintegrering
- Vad är Azure Logic Apps?
- B2B-integreringslösningar för företag med Azure Logic Apps och Enterprise Integration Pack
997 ACK-segment
Följande tabell beskriver 997 ACK-segmenten i ett utbyte och använder följande definitioner:
- M = Obligatoriskt
- O = Valfritt
| Position | Segment-ID | Name | Obligatorisk beteckning (Req. Des.) |
Maximal användning | Looprepetition |
|---|---|---|---|---|---|
| 010 | :A | Transaktionsuppsättningsrubrik för bekräftelsen | M | 1 | - |
| 020 | AK1 | Svarshuvud för funktionell grupp | M | 1 | - |
| 030 | AK2 | Svarshuvud för transaktionsuppsättning | O | 1 | 999999 (Loop-ID = AK2) |
| 040 | AK3 | Anteckning om datasegment | O | 1 | 999999 (Loop-ID = AK2 eller AK3) |
| 050 | AK4 | Anteckning om dataelement | O | 9 9 | - |
| 060 | AK5 | Svarstrailer för transaktionsuppsättning | M | 1 | - |
| 070 | AK9 | Funktionsgruppsvarstrailer | M | 1 | - |
| 080 | SE | Trailer för transaktionsuppsättning för bekräftelsen | M | 1 | - |
Följande avsnitt innehåller mer information om varje AK-segment. I AK2 till AK5-loopen ger segmenten information om ett fel med en transaktionsuppsättning.
AK1
Det obligatoriska AK1-segmentet identifierar den funktionella grupp som ska bekräftas med hjälp av följande dataelement:
| Element | Description |
|---|---|
| AK101 | Obligatoriskt identifierar det funktionella grupp-ID (GS01) som funktionsgruppen ska bekräfta. |
| AK102 | Obligatoriskt identifierar gruppkontrollnumret (GS06 och GE02) för den funktionella grupp som ska bekräftas. |
| AK103 | Valfritt identifierar EDI-implementeringsversionen som skickades i GS08 från den ursprungliga transaktionen. AK103 stöder en inkommande 5010-kompatibel 997 ACK. |
AK2
Det valfria AK2-segmentet innehåller en bekräftelse för en transaktionsuppsättning i den mottagna funktionella gruppen. Om det finns flera AK2-segment skickas de som en serie loopar. Varje AK2-loop identifierar en transaktionsuppsättning med hjälp av den mottagna ordern. Om en transaktionsuppsättning är felaktig innehåller en AK2-loop segmenten AK3, AK4 och AK5. Mer information finns i segmentbeskrivningarna senare i det här avsnittet.
AK2-segmentet identifierar transaktionsuppsättningen med hjälp av följande dataelement:
| Element | Description |
|---|---|
| AK201 | Obligatoriskt identifierar transaktionsuppsättningens ID (ST01) för den transaktionsuppsättning som ska bekräftas. |
| AK202 | Obligatoriskt identifierar transaktionsuppsättningens kontrollnummer (ST02 och SE02) för den transaktionsuppsättning som ska bekräftas. |
| AK203 | Valfritt, identifierar EDI-implementeringsversionen som skickades i ST03 för den ursprungliga transaktionen. AK203 stöder inkommande 5010-kompatibel 997. |
Generera AK2-segment
Du kan ange att AK2-segment genereras för alla godkända och avvisade transaktionsuppsättningar, eller bara för avvisade transaktionsuppsättningar. Annars genererar Azure Logic Apps ENDAST AK2-loopar för avvisade transaktionsuppsättningar. Om ett avtal inte matchar för utbytet som besvaras, standardinställningarna för 997-generationen till reservavtalsinställningarna och AK2-segment genereras inte för godkända transaktionsuppsättningar.
Följ dessa steg om du vill att Azure Logic Apps ska generera AK2-segment för godkända transaktionsuppsättningar där AK501 == A:
Öppna ditt integrationskonto i Azure Portal och öppna sedan X12-avtalsartefakten mellan dina X12-handelspartner.
Öppna fönstret Ta emot inställningar och se till att FA Expected visas markerat. Du kan sedan välja Inkludera AK2/IK2-loop.
AK3
Det valfria AK3-segmentet rapporterar fel i ett datasegment och identifierar platsen för datasegmentet. Ett AK3-segment skapas för varje segment i en transaktionsuppsättning som har ett eller flera fel. Om det finns flera AK3-segment skickas de som en serie loopar med ett segment per loop. AK3-segmentet anger platsen för varje segment i fel och rapporterar typen av syntaktiskt fel som hittades på den platsen med hjälp av följande dataelement:
| Element | Description |
|---|---|
| AK301 | Obligatoriskt identifierar segmentet i fel med X12-segment-ID, till exempel NM1. |
| AK302 | Obligatoriskt identifierar segmentantalet för segmentet i fel. ST-segmentet är 1, och varje segment ökar antalet segment med ett. |
| AK303 | Obligatoriskt identifierar en avgränsad loop, som är en loop omgiven av ett LS-segment (Loop Start) och ett Loop End-segment (LE). AK303 innehåller värdena för de LS- och LE-segment som band segmentet i fel. |
| AK304 | Valfritt anger koden för felet i datasegmentet. Även om AK304 är valfritt krävs elementet när det finns ett fel för det identifierade segmentet. För AK304-felkoder läser du 997 ACK-felkoder – Datasegmentanteckning. |
AK4
Det valfria AK4-segmentet rapporterar fel i ett dataelement eller en sammansatt datastruktur och identifierar platsen för dataelementet. Ett AK4-segment skickas när AK304-dataelementet är "8", "Segment has data element errors" och kan upprepas upp till 99 gånger inom varje AK3-segment. AK4-segmentet anger platsen för varje dataelement eller sammansatt datastruktur i fel och rapporterar typen av syntaktiskt fel som hittas på den platsen med hjälp av följande dataelement:
| Element | Description |
|---|---|
| AK401 | Obligatoriskt, ett sammansatt dataelement med följande fält: AK41.1, AK41.2 och AK41.3 – AK401.1: Identifierar dataelementet eller den sammansatta datastrukturen i fel med hjälp av dess numeriska antal. Om det andra dataelementet i segmentet till exempel har ett fel är AK401 lika med |
| AK402 | Valfritt, identifierar det enkla X12-dataelementnumret för elementet i fel. Till exempel är NM101 det enkla X12-dataelementnumret 98. |
| AK403 | Obligatoriskt rapporterar felet för det identifierade elementet. För AK403-felkoder läser du 997 ACK-felkoder – Dataelementanteckning. |
| AK404 | Valfritt, innehåller en kopia av det identifierade dataelementet i fel. AK404 används inte om felet anger ett ogiltigt tecken. |
AK5
AK5-segmentet rapporterar om transaktionsuppsättningen som identifieras i AK2-segmentet accepteras eller avvisas och varför. AK5-segmentet är obligatoriskt när den valfria AK2-loopen ingår i bekräftelsen. AK4-segmentet anger status för transaktionsuppsättningen med hjälp av ett enda obligatoriskt dataelement och tillhandahåller felkoder som använder mellan ett till fem valfria dataelement, baserat på syntaxredigering av transaktionsuppsättningen.
| Element | Description |
|---|---|
| AK501 | Obligatoriskt anger om den identifierade transaktionsuppsättningen godkänns eller avvisas. För AK501-felkoder läser du 997 ACK-felkoder – Transaktionssvarstrailer. |
| AK502 – AK506 | Valfritt, ange typ av fel. För AK502-felkoder läser du 997 ACK-felkoder – Svarstrailer för transaktionsuppsättningar. |
AK9
Det obligatoriska AK9-segmentet anger om den funktionella grupp som identifieras i AK1-segmentet accepteras eller avvisas och varför. AK9-segmentet anger status för transaktionsuppsättningen och typen av fel med hjälp av fyra obligatoriska dataelement. Segmentet anger eventuella antecknade fel med hjälp av mellan ett och fem valfria element.
| Element | Description |
|---|---|
| AK901 | Obligatoriskt anger om den funktionella grupp som identifieras i AK1 godkänns eller avvisas. För AK901-felkoder läser du 997 ACK-felkoder – Funktionell gruppsvarstrailer. |
| AK902 | Obligatoriskt anger antalet transaktionsuppsättningar som ingår i den identifierade funktionella grupptrailern (GE01). |
| AK903 | Obligatoriskt anger antalet mottagna transaktionsuppsättningar. |
| AK904 | Obligatoriskt anger antalet transaktionsuppsättningar som godkänts i den identifierade funktionella gruppen. |
| AK905 – AK909 | Valfritt, anger från ett till fem fel som anges i den identifierade funktionella gruppen. För AK905 till AK909-felkoder läser du 997 ACK-felkoder – Funktionell gruppsvarstrailer. |
997 ACK-felkoder
Det här avsnittet beskriver de felkoder som används i 997 ACK-segment. Varje tabell visar de felkoder som stöds och som inte stöds, enligt definitionen i X12-specifikationen, för X12-meddelandebearbetning i Azure Logic Apps.
AK304-felkoder – Datasegmentanteckning
I följande tabell visas de felkoder som används i AK304-dataelementet i AK3-segmentet (datasegmentanteckning):
| Felkod | Villkor | Stöds? |
|---|---|---|
| 1 | Okänt segment-ID | Ja |
| 2 | Oväntat segment | Ja |
| 3 | Obligatoriskt segment saknas | Ja |
| 4 | Loopen sker över maximala tider | Ja |
| 5 | Segmentet överskrider maximal användning | Ja |
| 6 | Segment som inte finns i definierad transaktionsuppsättning | Ja |
| 7 | Segmentet är inte i rätt ordning | Ja |
| 8 | Segmentet har dataelementfel | Ja |
| 511 | Efterföljande avgränsare påträffades (anpassad kod) | Ja |
AK403-felkoder – Dataelementanteckning
I följande tabell visas de felkoder som används i AK403-dataelementet i AK4-segmentet (dataelementanteckning):
| Felkod | Villkor | Stöds? |
|---|---|---|
| 1 | Obligatoriskt dataelement saknas | Ja |
| 2 | Villkorsstyrd obligatoriskt dataelement saknas | Ja |
| 3 | För många dataelement | Ja |
| 4 | Dataelementet är för kort | Ja |
| 5 | Dataelementet är för långt | Ja |
| 6 | Ogiltigt tecken i dataelement | Ja |
| 7 | Ogiltigt kodvärde | Ja |
| 8 | Ogiltigt datum | Ja |
| 9 | Ogiltig tid | Ja |
| 10 | Exkluderingsvillkoret har brutits | Ja |
AK501-felkoder – Svarstrailer för transaktionsuppsättning
I följande tabell visas de felkoder som används i AK501-dataelementet i AK5-segmentet (transaktionsuppsättningens svarstrailer):
| Felkod | Villkor | Stöds? |
|---|---|---|
| A | Har godkänts | Ja |
| Ö | Accepterades men fel noterades | Ja
Obs! Inga felkoder leder till statusen |
| M | Avvisad, meddelandeautentiseringskoden (MAC) misslyckades | Nej |
| P | Delvis godkänd, minst en transaktionsuppsättning avvisades | Ja |
| R | Avvisat | Ja |
| O | Avvisade, verifieringen misslyckades med giltighetstester | Nej |
| X | Avvisad, innehåll efter dekryptering kunde inte analyseras | Nej |
AK502 till AK506-felkoder – Svarstrailer för transaktionsuppsättning
I följande tabell visas de felkoder som används i AK502 till AK506-dataelementen i AK5-segmentet (transaktionsuppsättningens svarstrailer):
| Felkod | Villkor | Stöds eller korrelerad med AK501? |
|---|---|---|
| 1 | Transaktionsuppsättningen stöds inte | Ja, R |
| 2 | Trailer för transaktionsuppsättning saknas | Ja, R |
| 3 | Kontrollnumret för transaktionsuppsättningen i sidhuvud och trailer matchar inte | Ja, R |
| 4 | Antalet inkluderade segment matchar inte det faktiska antalet | Ja, R |
| 5 | Ett eller flera segment i fel | Ja, R |
| 6 | Identifierare för transaktionsuppsättning saknas eller är ogiltig | Ja, R |
| 7 | Ett duplicerat transaktionsnummer kan ha inträffat eller ogiltigt kontrollnummer för transaktionsuppsättningen | Ja, R |
| 8 till 27 | - | Nej |
AK901-felkoder – Funktionsgruppsvarstrailer
I följande tabell visas de felkoder som används i AK901-dataelementen i AK9-segmentet (funktionell gruppsvarstrailer):
| Felkod | Villkor | Stöds eller korrelerad med AK501? |
|---|---|---|
| A | Har godkänts | Ja |
| Ö | Accepterad, men fel noterades | Ja |
| M | Avvisad, meddelandeautentiseringskoden (MAC) misslyckades | Nej |
| P | Delvis godkänd, minst en transaktionsuppsättning avvisades | Ja |
| R | Avvisat | Ja |
| O | Avvisade, verifieringen misslyckades med giltighetstester | Nej |
| X | Avvisad, innehåll efter dekryptering kunde inte analyseras | Nej |
AK905 till AK909-felkoder – Funktionell gruppsvarstrailer
I följande tabell visas de felkoder som används i AK905 till AK909-dataelementen i AK9-segmentet (Funktionell gruppsvarstrailer):
| Felkod | Villkor | Stöds eller korrelerad med AK501? |
|---|---|---|
| 1 | Funktionsgrupp stöds inte | Nej |
| 2 | Funktionell gruppversion stöds inte | Nej |
| 3 | Funktionell grupptrailer saknas | Ja |
| 4 | Gruppkontrollnummer i den funktionella grupprubriken och trailern godkänner inte | Ja |
| 5 | Antalet inkluderade transaktionsuppsättningar matchar inte det faktiska antalet | Ja |
| 6 | Gruppkontrollnummer bryter mot syntaxen, ett duplicerat gruppkontrollnummer kan ha inträffat | Ja |
| 7 till 26 | - | Nej |