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ärden och X12-avkodningsåtgärden kan verifiera en 5010-kompatibel 997 ACK.
Mottagaren skickar 997 ACK i ett GS-kuvert (Functional Group Header) och ETT GE-kuvert (Functional Group Trailer). 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 felkoderna som används i dessa segment. Mer relaterad information finns i följande dokumentation:
- Tekniska bekräftelser och felkoder för X12 TA1
- 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 | ST | 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 | Datasegmentanteckning | 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 | Transaktionsuppsättningstrailer 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 | Beskrivning |
|---|---|
| AK101 | Obligatoriskt identifierar funktionsgrupps-ID (GS01) för den funktionella grupp som ska bekräftas. |
| AK102 | Obligatoriskt, identifierar gruppkontrollnumret (GS06 och GE02) för den funktionella grupp som ska bekräftas. |
| AK103 | Valfritt identifierar den EDI-implementeringsversion 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 har fel 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 | Beskrivning |
|---|---|
| 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 transaktionen som ska bekräftas. |
| AK203 | Valfritt identifierar den EDI-implementeringsversion 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 accepterade 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 det utbyte som besvaras genereras inte 997-generationens inställningar som standard för reservavtalsinställningarna och AK2-segmenten för godkända transaktionsuppsättningar.
Följ dessa steg för att låta Azure Logic Apps 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 | Beskrivning |
|---|---|
| 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 1och 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 hittades på den platsen med hjälp av följande dataelement:
| Element | Beskrivning |
|---|---|
| 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 |
| AK402 | Valfritt, identifierar det enkla X12-dataelementnumret för elementet i fel. NM101 är till exempel 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 ett enda obligatoriskt dataelement och innehåller felkoder som använder mellan ett till fem valfria dataelement, baserat på syntaxredigeringen för transaktionsuppsättningen.
| Element | Beskrivning |
|---|---|
| AK501 | Obligatoriskt anger om den identifierade transaktionsuppsättningen godkänns eller avvisas. För AK501-felkoder läser du 997 ACK-felkoder – Trailer för transaktionssvar. |
| AK502 – AK506 | Valfritt, ange typen 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 | Beskrivning |
|---|---|
| AK901 | Obligatoriskt anger om den funktionella grupp som identifieras i AK1 accepteras eller avvisas. För AK901-felkoder läser du 997 ACK-felkoder – Funktionsgruppsvarstrailer. |
| 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 accepteras 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 – Funktionsgruppsvarstrailer. |
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 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 | Yes |
| 2 | Oväntat segment | Yes |
| 3 | Obligatoriskt segment saknas | Yes |
| 4 | Loopen inträffar över maximala tider | Yes |
| 5 | Segmentet överskrider maximal användning | Yes |
| 6 | Segment som inte finns i definierad transaktionsuppsättning | Yes |
| 7 | Segmentet är inte i rätt ordning | Yes |
| 8 | Segmentet har dataelementfel | Yes |
| 511 | Efterföljande avgränsare påträffades (anpassad kod) | Yes |
AK403-felkoder – Anteckning om dataelement
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 | Yes |
| 2 | Villkorsstyrt obligatoriskt dataelement saknas | Yes |
| 3 | För många dataelement | Yes |
| 4 | Dataelementet är för kort | Yes |
| 5 | Dataelementet är för långt | Yes |
| 6 | Ogiltigt tecken i dataelement | Yes |
| 7 | Ogiltigt kodvärde | Yes |
| 8 | Ogiltigt datum | Yes |
| 9 | Ogiltig tid | Yes |
| 10 | Exkluderingsvillkoret har brutits | Yes |
AK501-felkoder – Svarstrailer för transaktionsuppsättning
I följande tabell visas de felkoder som används i AK501-dataelementet i AK5-segmentet (Transaction Set Response Trailer):
| Felkod | Villkor | Stöds? |
|---|---|---|
| A | Har godkänts | Yes |
| E | Accepterades men fel noterades | Yes
Obs! Inga felkoder leder till statusen |
| M | Avvisad, meddelandeautentiseringskoden (MAC) misslyckades | No |
| P | Delvis godkänd, minst en transaktionsuppsättning avvisades | Yes |
| R | Avslagen | Yes |
| W | Avvisad, valideringstesterna misslyckades | No |
| X | Avvisad, innehåll efter dekryptering kunde inte analyseras | No |
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 (Transaction Set Response Trailer):
| Felkod | Villkor | Stöds eller korrelerat med AK501? |
|---|---|---|
| 1 | Transaktionsuppsättningen stöds inte | Ja, R |
| 2 | Trailer för transaktionsuppsättning saknas | Ja, R |
| 3 | Transaktionsuppsättningens kontrollnummer 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 | Kontrollnumret för transaktionsuppsättningen saknas eller är ogiltigt. Ett duplicerat transaktionsnummer kan ha inträffat | Ja, R |
| 8 till 27 | - | No |
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 korrelerat med AK501? |
|---|---|---|
| A | Har godkänts | Yes |
| E | Accepterades, men fel noterades | Yes |
| M | Avvisad, meddelandeautentiseringskoden (MAC) misslyckades | No |
| P | Delvis godkänd, minst en transaktionsuppsättning avvisades | Yes |
| R | Avslagen | Yes |
| W | Avvisad, valideringstesterna misslyckades | No |
| X | Avvisad, innehåll efter dekryptering kunde inte analyseras | No |
AK905 till AK909-felkoder – Funktionsgruppsvarstrailer
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 korrelerat med AK501? |
|---|---|---|
| 1 | Funktionsgrupp stöds inte | No |
| 2 | Funktionell gruppversion stöds inte | No |
| 3 | Funktionell grupptrailer saknas | Yes |
| 4 | Gruppkontrollnumret i den funktionella grupprubriken och trailern accepterar inte | Yes |
| 5 | Antalet inkluderade transaktionsuppsättningar matchar inte det faktiska antalet | Yes |
| 6 | Gruppkontrollnummer bryter mot syntaxen, ett duplicerat gruppkontrollnummer kan ha inträffat | Yes |
| 7 till 26 | - | Nej |