997-Funktionsbestätigungen und -Fehlercodes für X12-Nachrichten in Azure Logic Apps
Gilt für: Azure Logic Apps (Verbrauch + Standard)
Sie können in Azure Logic Apps Workflows erstellen, die X12-Nachrichten für die EDI-Kommunikation (Electronic Data Interchange) verarbeiten, wenn Sie X12-Vorgänge verwenden. Beim EDI-Messaging geben Bestätigungen den Status der Verarbeitung eines EDI-Austauschs an. Beim Empfang eines Austauschs kann die X12-Decodierungsaktion mehrere Typen von Bestätigungen an den Absender zurückgeben. Dies hängt davon ab, welche Bestätigungstypen aktiviert sind und welche Überprüfungsebene angegeben wurde.
Beispielsweise meldet der Empfänger den Status der Überprüfung von Funktionsgruppenheader (GS) und Funktionsgruppennachspann (GE) in der empfangenen X12-codierten Nachricht, indem er eine 997-Funktionsbestätigung (ACK) zusammen mit jedem Fehler sendet, der während der Verarbeitung aufgetreten ist. Die X12-Decodierungsaktion generiert immer eine 4010-konforme 997-Funktionsbestätigung, während sowohl die X12-Codierungsaktion als auch die X12-Decodierungsaktion eine 5010-kompatible 997-Funktionsbestätigung überprüfen können.
Der Empfänger sendet die 997-Bestätigung in einem GS- (Funktionsgruppenheader) und GE-Umschlag (Funktionsgruppennachspann). Dieser GS- und GE-Umschlag unterscheidet sich jedoch nicht von den anderen Transaktionssätzen.
In diesem Thema finden Sie eine kurze Übersicht über die 997-Bestätigung von X12, einschließlich der Segmente von 997-Funktionsbestätigungen bei einem Austausch und der in diesen Segmenten verwendeten Fehlercodes. Weiterführende Informationen finden Sie in der folgenden Dokumentation:
- X12: Technische TA1-Bestätigungen und Fehlercodes
- Austauschen von X12-Nachrichten für die B2B-Unternehmensintegration
- Austauschen von EDIFACT-Nachrichten für die B2B-Unternehmensintegration
- Was ist Azure Logic Apps?
- B2B-Unternehmensintegrationslösungen mit Azure Logic Apps und dem Enterprise Integration Pack
Segmente in 997-Funktionsbestätigungen
In der folgenden Tabelle sind die Segmente in 997-Bestätigungen bei einem Austausch beschrieben. Dabei werden die folgenden Definitionen angewandt:
- V = Verbindlich
- O = Optional
| Position | Segment-ID | Name | Erforderliche Bezeichnung (Erf. Bez.) |
Maximale Nutzung | Schleifenwiederholung |
|---|---|---|---|---|---|
| 010 | ST | Transaktionssatzheader, für die Bestätigung | M | 1 | - |
| 020 | AK1 | Funktionsgruppen-Antwortheader | M | 1 | - |
| 030 | AK2 | Transaktionssatz-Antwortheader | O | 1 | 999999 (Schleifen-ID = AK2) |
| 040 | AK3 | Datensegmenthinweis | O | 1 | 999999 (Schleifen-ID = AK2 oder AK3) |
| 050 | AK4 | Datenelementhinweis | O | 9 9 | - |
| 060 | AK5 | Transaktionssatz-Antwortnachspann | M | 1 | - |
| 070 | AK9 | Funktionsgruppen-Antwortnachspann | M | 1 | - |
| 080 | SE | Transaktionssatznachspann für die Bestätigung | M | 1 | - |
In den folgenden Abschnitten finden Sie weitere Informationen zu den einzelnen Bestätigungssegmenten. Die Segmente in den Schleifen AK2 bis AK5 liefern Informationen zu einem Fehler mit einem Transaktionssatz.
AK1
Das verbindliche Segment AK1 gibt die Funktionsgruppe an, die mit den folgenden Datenelementen bestätigt wird:
| Element | BESCHREIBUNG |
|---|---|
| AK101 | Verbindlich, identifiziert die Funktionsgruppen-ID (GS01), die von der Funktionsgruppe bestätigt werden soll |
| AK102 | Verbindlich, identifiziert die Kontrollnummer der Gruppe (GS06 und GE02), die von der Funktionsgruppe bestätigt werden soll |
| AK103 | Optional, identifiziert die EDI-Implementierungsversion, die im GS08-Segment der ursprünglichen Transaktion gesendet wurde. AK103 unterstützt eine eingehende 5010-konforme 997-Bestätigung. |
AK2
Das optionale Segment AK2 enthält eine Bestätigung für einen Transaktionssatz in der empfangenen Funktionsgruppe. Wenn mehrere AK2-Segmente vorhanden sind, werden sie als eine Reihe von Schleifen gesendet. Jede AK2-Schleife identifiziert einen Transaktionssatz in der empfangenen Reihenfolge. Eine AK2-Schleife enthält AK3-, AK4- und AK5-Segmente, sofern ein Transaktionssatz Fehler aufweist. Weitere Informationen finden Sie weiter unten in den Segmentbeschreibungen.
Das AK2-Segment identifiziert den Transaktionssatz mithilfe der folgenden Datenelemente:
| Element | BESCHREIBUNG |
|---|---|
| AK201 | Verbindlich, identifiziert die Transaktionssatz-ID (ST01) des zu bestätigenden Transaktionssatzes |
| AK202 | Verbindlich, identifiziert die Transaktionssatz-Kontrollnummer (ST02 und SE02) des zu bestätigenden Transaktionssatzes |
| AK203 | Optional, identifiziert die EDI-Implementierungsversion, die im ST03-Segment der ursprünglichen Transaktion gesendet wurde. AK203 unterstützt eingehende 5010-konforme 997-Bestätigungen. |
Generieren von AK2-Segmenten
Sie können angeben, dass AK2-Segmente für alle akzeptierten oder abgelehnten Transaktionssätze oder nur für abgelehnte Transaktionssätze generiert werden. Andernfalls generiert Azure Logic Apps AK2-Schleifen nur für abgelehnte Transaktionssätze. Wenn eine Vereinbarung für den Austausch, auf den geantwortet wird, nicht aufgelöst wird, werden die Erstellungseinstellungen der 997-Funktionsbestätigung standardmäßig auf die Ausweichvereinbarungseinstellungen festgelegt und für akzeptierte Transaktionssätze keine AK2-Segmente generiert.
Damit Azure Logic Apps AK2-Segmente für akzeptierte Transaktionssätze generiert, bei denen AK501 == A ist, führen Sie die folgenden Schritte aus:
Öffnen Sie Ihr Integrationskonto im Azure-Portal, und öffnen Sie dann das X12-Vereinbarungsartefakt zwischen Ihren X12-Handelspartnern.
Öffnen Sie den Bereich Empfangseinstellungen, und stellen Sie sicher, dass FA erwartet ausgewählt ist. Sie können dann AK2-/IK2-Schleife einschließen auswählen.
AK3
Das optionale AK3-Segment meldet Fehler in einem Datensegment und bestimmt dessen Position. Ein AK3-Segment wird für jedes Segment in einem Transaktionssatz mit einem oder mehreren Fehlern erzeugt. Wenn mehrere AK3-Segmente vorhanden sind, werden sie als eine Reihe von Schleifen mit einem Segment pro Schleife gesendet. Das AK3-Segment gibt die Position jedes fehlerhaften Segments an und meldet den Typ des Syntaxfehlers an der jeweiligen Position anhand der folgenden Datenelemente:
| Element | BESCHREIBUNG |
|---|---|
| AK301 | Verbindlich, identifiziert das fehlerhafte Segment anhand seiner X12-Segment-ID, z. B. NM1. |
| AK302 | Verbindlich, identifiziert die Segmentnummer des fehlerhaften Segments. Das ST-Segment ist 1, und jedes Segment erhöht den Segmentzähler um 1. |
| AK303 | Erforderlich; identifiziert eine gebundene Schleife, die von einem LS-Segment (Loop Start, Schleifenstart) und einem LE-Segment (Loop End, Schleifenende) eingeschlossen ist. AK303 enthält die Werte der LS- und LE-Segmente, die das fehlerhafte Segment gebunden haben. |
| AK304 | Optional, gibt den Code für den Fehler im Datensegment an. AK304 ist zwar optional, das Element ist jedoch erforderlich, wenn ein Fehler für das identifizierte Segment vorhanden ist. Informationen zu AK304-Fehlercodes finden Sie unter Fehlercodes in 997-Bestätigungen: Datensegmenthinweis. |
AK4
Das optionale AK4-Segment meldet Fehler in einem Datensegment oder einer zusammengesetzten Datenstruktur und bestimmt die Position des Datenelements. Ein AK4-Segment wird gesendet, wenn das AK304-Datenelement "8", "Segment has data element errors" ist. Es kann innerhalb jedes AK3-Segments bis zu 99-mal wiederholt werden. Das AK4-Segment gibt die Position jedes fehlerhaften Datenelements bzw. jeder fehlerhaften zusammengesetzten Datenstruktur an und meldet den Typ des Syntaxfehlers an der jeweiligen Position anhand der folgenden vier Datenelemente:
| Element | BESCHREIBUNG |
|---|---|
| AK401 | Verbindlich, ein zusammengesetztes Datenelement mit den folgenden Feldern: AK41.1, AK41.2 und AK41.3 - AK401.1: identifiziert das Datenelement oder die zusammengesetzte Datenstruktur mit dem Fehler anhand seiner Nummer. Wenn beispielsweise das zweite Datenelement im Segment einen Fehler aufweist, hat AK401 den Wert |
| AK402 | Optional, identifiziert die einfache X12-Datenelementnummer des fehlerhaften Elements. NM101 entspricht beispielsweise der einfachen X12-Datenelementnummer 98. |
| AK403 | Verbindlich, meldet den Fehler im identifizierten Element. Informationen zu AK403-Fehlercodes finden Sie unter Fehlercodes in 997-Bestätigungen: Datenelementhinweis. |
| AK404 | Optional, enthält eine Kopie des identifizierten fehlerhaften Datenelements. AK404 wird nicht verwendet, wenn der Fehler ein ungültiges Zeichen angibt. |
AK5
Das AK5-Segment meldet, ob der im AK2-Segment bestimmte Transaktionssatz akzeptiert oder (unter Angabe von Gründen) abgelehnt wird. Das AK5-Segment ist verbindlich, wenn die optionale AK2-Schleife in die Bestätigung einbezogen ist. Das AK4-Segment gibt mit einem verbindlichen Datenelement den Status des Transaktionssatzes an und stellt anhand von ein bis fünf optionalen Datenelementen basierend auf der Syntaxbearbeitung des Transaktionssatzes Fehlercodes bereit.
| Element | BESCHREIBUNG |
|---|---|
| AK501 | Verbindlich, gibt an, ob der identifizierte Transaktionssatz akzeptiert oder abgelehnt wurde. Informationen zu AK501-Fehlercodes finden Sie unter Fehlercodes in 997-Bestätigungen: Transaktionsantwortnachspann. |
| AK502–AK506 | Optional, gibt die Art des Fehlers an. Informationen zu AK502-Fehlercodes finden Sie unter Fehlercodes in 997-Bestätigungen: Transaktionssatz-Antwortnachspann. |
AK9
Das verbindliche AK9-Segment gibt an, ob die im AK1-Segment bestimmte Funktionsgruppe akzeptiert oder (unter Angabe von Gründen) abgelehnt wird. Das AK9-Segment gibt den Status des Transaktionssatzes und die Art eventueller Fehler mithilfe von vier verbindlichen Datenelementen an. Das Segment gibt alle gemeldeten Fehler über ein bis fünf optionale Elemente an.
| Element | BESCHREIBUNG |
|---|---|
| AK901 | Verbindlich, gibt an, ob die im AK1-Segment identifizierte Funktionsgruppe akzeptiert oder abgelehnt wurde. Informationen zu AK901-Fehlercodes finden Sie unter Fehlercodes in 997-Bestätigungen: Funktionsgruppen-Antwortnachspann. |
| AK902 | Verbindlich, gibt die Anzahl der Transaktionssätze im identifizierten Funktionsgruppennachspann (GE01) an. |
| AK903 | Verbindlich, gibt die Anzahl der empfangenen Transaktionsätze an. |
| AK904 | Verbindlich, gibt die Anzahl der Transaktionssätze an, die in der identifizierten Funktionsgruppe akzeptiert wurden. |
| AK905–AK909 | Optional, gibt ein bis fünf Fehler an, die in der identifizierten Funktionsgruppe gemeldet wurden. Informationen zu Fehlercodes in AK905–AK909 finden Sie unter Fehlercodes in 997-Bestätigungen: Funktionsgruppen-Antwortnachspann. |
Fehlercodes in 997-Bestätigungen
In diesem Abschnitt werden die Fehlercodes behandelt, die in Segmenten in 997-Bestätigungen verwendet werden. In jeder Tabelle werden die unterstützten und nicht unterstützten Fehlercodes gemäß der X12-Spezifikation aufgeführt, die bei der X12-Nachrichtenverarbeitung in Azure Logic Apps verwendet werden.
AK304-Fehlercodes: Datensegmenthinweis
In der folgenden Tabelle werden die Fehlercodes aufgelistet, die im Datenelement AK304 des AK3-Segments (Datensegmenthinweis) verwendet werden:
| Fehlercode | Bedingung | Unterstützt? |
|---|---|---|
| 1 | Unbekannte Segment-ID. | Ja |
| 2 | Unerwartetes Segment | Ja |
| 3 | Obligatorisches Segment fehlt | Ja |
| 4 | Schleife tritt häufiger auf als die zulässige Maximalanzahl | Ja |
| 5 | Segment überschreitet maximale Verwendung | Ja |
| 6 | Segment nicht im Transaktionssatz definiert | Ja |
| 7 | Sequenz des Segments nicht ordnungsgemäß | Ja |
| 8 | Datenelementfehler im Segment | Ja |
| 511 | Nachfolgendes Trennzeichen gefunden (benutzerdefinierter Code) | Ja |
AK403-Fehlercodes: Datenelementhinweis
In der folgenden Tabelle werden die Fehlercodes aufgelistet, die im Datenelement AK403 des AK4-Segments (Datenelementhinweis) verwendet werden:
| Fehlercode | Bedingung | Unterstützt? |
|---|---|---|
| 1 | Obligatorisches Datenelement fehlt | Ja |
| 2 | Erforderliches Bedingungsdatenelement fehlt | Ja |
| 3 | Zu viele Datenelemente | Ja |
| 4 | Datenelement zu kurz | Ja |
| 5 | Datenelement zu lang | Ja |
| 6 | Ungültiges Zeichen in Datenelement | Ja |
| 7 | Ungültiger Codewert | Ja |
| 8 | Ungültiges Datum | Ja |
| 9 | Ungültige Zeit | Ja |
| 10 | Ausschlussbedingung verletzt | Ja |
AK501-Fehlercodes: Transaktionssatz-Antwortnachspann
In der folgenden Tabelle werden die Fehlercodes aufgelistet, die im Datenelement AK501 des AK5-Segments (Transaktionssatz-Antwortnachspann) verwendet werden:
| Fehlercode | Bedingung | Unterstützt? |
|---|---|---|
| Ein | Akzeptiert | Ja |
| E | Akzeptiert, es wurden allerdings Fehler festgestellt | Ja
Hinweis: Keiner der Fehlercodes führt zum Status |
| M | Abgelehnt, Fehler beim Nachrichtenauthentifizierungscode (MAC) | Nein |
| P | Teilweise akzeptiert, mindestens ein Transaktionssatz wurde abgelehnt | Ja |
| R | Rejected (Abgelehnt) | Ja |
| W | Abgelehnt, Fehler bei Gültigkeitstests für Sicherung | Nein |
| X | Abgelehnt, Inhalt konnte nach Entschlüsselung nicht analysiert werden | Nein |
Fehlercodes AK502–AK506: Transaktionssatz-Antwortnachspann
In der folgenden Tabelle werden die Fehlercodes aufgelistet, die in den Datenelementen AK502 bis AK506 des AK5-Segments (Transaktionssatz-Antwortnachspann) verwendet werden:
| Fehlercode | Bedingung | Unterstützt oder korreliert mit AK501? |
|---|---|---|
| 1 | Transaktionssatz nicht unterstützt | Ja, R |
| 2 | Transaktionssatz-Nachspann fehlt | Ja, R |
| 3 | Transaktionssatz-Kontrollnummer im Vorspann und Nachspann stimmen nicht überein | Ja, R |
| 4 | Anzahl einbezogener Segmente stimmt nicht mit tatsächlicher Anzahl überein | Ja, R |
| 5 | Fehler in mehreren Segmenten | Ja, R |
| 6 | Fehlender oder ungültiger Transaktionssatzbezeichner | Ja, R |
| 7 | Fehlende oder ungültige Transaktionssatz-Kontrollnummer, möglicherweise ist eine doppelte Transaktionsnummer aufgetreten | Ja, R |
| 8 bis 27 | - | Nein |
AK901-Fehlercodes: Funktionsgruppen-Antwortnachspann
In der folgenden Tabelle werden die Fehlercodes aufgelistet, die im Datenelement AK901 des AK9-Segments (Funktionsgruppen-Antwortnachspann) verwendet werden:
| Fehlercode | Bedingung | Unterstützt oder korreliert mit AK501? |
|---|---|---|
| Ein | Akzeptiert | Ja |
| E | Akzeptiert, es wurden allerdings Fehler festgestellt | Ja |
| M | Abgelehnt, Fehler beim Nachrichtenauthentifizierungscode (MAC) | Nein |
| P | Teilweise akzeptiert, mindestens ein Transaktionssatz wurde abgelehnt | Ja |
| R | Rejected (Abgelehnt) | Ja |
| W | Abgelehnt, Fehler bei Gültigkeitstests für Sicherung | Nein |
| X | Abgelehnt, Inhalt konnte nach Entschlüsselung nicht analysiert werden | Nein |
Fehlercodes AK905–AK909: Funktionsgruppen-Antwortnachspann
In der folgenden Tabelle werden die Fehlercodes aufgelistet, die in den Datenelementen AK905 bis AK909 des AK9-Segments (Funktionsgruppen-Antwortnachspann) verwendet werden:
| Fehlercode | Bedingung | Unterstützt oder korreliert mit AK501? |
|---|---|---|
| 1 | Funktionsgruppe nicht unterstützt | Nein |
| 2 | Funktionsgruppenversion nicht unterstützt | Nein |
| 3 | Funktionsgruppen-Nachspann fehlt | Ja |
| 4 | Gruppenkontrollnummer im Vorspann und Nachspann der Funktionsgruppe stimmen nicht überein | Ja |
| 5 | Anzahl einbezogener Transaktionssätze stimmt nicht mit tatsächlicher Anzahl überein | Ja |
| 6 | Gruppenkontrollnummer verletzt Syntax, möglicherweise ist eine doppelte Gruppenkontrollnummer aufgetreten | Ja |
| 7 bis 26 | - | Nein |