997 functionele bevestigingen en foutcodes voor X12-berichten in Azure Logic Apps
Van toepassing op: Azure Logic Apps (verbruik + standaard)
In Azure Logic Apps kunt u werkstromen maken die X12-berichten verwerken voor EDI-communicatie (Electronic Data Interchange) wanneer u X12-bewerkingen gebruikt. In EDI-berichten bieden bevestigingen de status van het verwerken van een EDI-uitwisseling. Wanneer u een uitwisseling ontvangt, kan de X12-decodeeractie een of meer typen bevestigingen naar de afzender retourneren, op basis van welke bevestigingstypen zijn ingeschakeld en het opgegeven validatieniveau.
De ontvanger rapporteert bijvoorbeeld de status van het valideren van de functionele groepsheader (GS) en functionele groepstrailer (GE) in het ontvangen X12-gecodeerde bericht door een 997 functionele bevestiging (ACK) te verzenden, samen met elke fout die optreedt tijdens de verwerking. De actie X12 decoderen genereert altijd een 4010-compatibele 997 ACK, terwijl zowel de actie X12 coderen als de actie X12 decoderen een 5010-compatibele 997 ACK kan valideren.
De ontvanger verzendt de 997 ACK binnen een envelop met de functiegroepheader (GS) en een functionele groep trailer (GE). Deze GS- en GE-envelop is echter niet anders dan in een andere transactieset.
In dit onderwerp vindt u een kort overzicht van de X12 997 ACK, met inbegrip van de 997 ACK-segmenten in een uitwisseling en de foutcodes die in deze segmenten worden gebruikt. Raadpleeg de volgende documentatie voor andere gerelateerde informatie:
- Technische bevestigingen en foutcodes van X12 TA1
- X12-berichten uitwisselen voor B2B Enterprise-integratie
- EDIFACT-berichten uitwisselen voor B2B Enterprise-integratie
- Wat is Azure Logic Apps?
- B2B-bedrijfsintegratieoplossingen met Azure Logic Apps en Enterprise Integration Pack
997 ACK-segmenten
In de volgende tabel worden de 997 ACK-segmenten in een uitwisseling beschreven en worden de volgende definities gebruikt:
- M = verplicht
- O = Optioneel
| Positie | Segment-id | Naam | Vereiste aanduiding (Req. Des.) |
Maximaal gebruik | Herhalen van lus |
|---|---|---|---|---|---|
| 010 | ST | Transactiesetheader, ter bevestiging | M | 1 | - |
| 020 | AK1 | Antwoordheader van functionele groep | M | 1 | - |
| 030 | AK2 | Antwoordheader van transactieset | O | 1 | 999999 (Lus-id = AK2) |
| 040 | AK3 | Gegevenssegmentnotitie | O | 1 | 999999 (Lus-id = AK2 of AK3) |
| 050 | AK4 | Opmerking over het gegevenselement | O | 9 9 | - |
| 060 | AK5 | Antwoordtrailer transactieset | M | 1 | - |
| 070 | AK9 | Antwoordtrailer voor functionele groepen | M | 1 | - |
| 080 | SE | Transactiesettrailer, ter bevestiging | M | 1 | - |
De volgende secties bevatten meer informatie over elk AK-segment. In de lus AK2 naar AK5 bieden de segmenten informatie over een fout met een transactieset.
AK1
Het verplichte AK1-segment identificeert de functionele groep die moet worden bevestigd met behulp van de volgende gegevenselementen:
| Element | Beschrijving |
|---|---|
| AK101 | Verplicht, identificeert de functionele groeps-id (GS01) die de functionele groep moet bevestigen. |
| AK102 | Verplicht, identificeert het controlenummer van de groep (GS06 en GE02) voor de functionele groep om te bevestigen. |
| AK103 | Optioneel, identificeert de EDI-implementatieversie die is verzonden in de GS08 vanaf de oorspronkelijke transactie. AK103 ondersteunt een binnenkomende 5010-compatibele 997 ACK. |
AK2
Het optionele AK2-segment bevat een bevestiging voor een transactieset in de ontvangen functionele groep. Als er meerdere AK2-segmenten bestaan, worden deze verzonden als een reeks lussen. Elke AK2-lus identificeert een transactieset met behulp van de ontvangen order. Als een transactieset een fout heeft, bevat een AK2-lus AK3-, AK4- en AK5-segmenten. Bekijk de segmentbeschrijvingen verderop in dit onderwerp voor meer informatie.
Het AK2-segment identificeert de transactieset met behulp van de volgende gegevenselementen:
| Element | Beschrijving |
|---|---|
| AK201 | Verplicht, identificeert de transactieset-id (ST01) van de transactieset die moet worden bevestigd. |
| AK202 | Verplicht, identificeert het controlenummer van de transactieset (ST02 en SE02) van de transactieset die moet worden bevestigd. |
| AK203 | Optioneel, identificeert de EDI-implementatieversie die is verzonden in de ST03 van de oorspronkelijke transactie. AK203 ondersteunt inkomende 5010-compatibele 997. |
AK2-segmenten genereren
U kunt opgeven dat AK2-segmenten worden gegenereerd voor alle geaccepteerde en geweigerde transactiesets, of alleen voor geweigerde transactiesets. Anders genereert Azure Logic Apps alleen AK2-lussen voor geweigerde transactiesets. Als een overeenkomst niet wordt opgelost voor de uitwisseling waar op wordt gereageerd, worden de instellingen voor de 997-generatie standaard ingesteld op de instellingen van de terugvalovereenkomst en worden AK2-segmenten niet gegenereerd voor geaccepteerde transactiesets.
Voer de volgende stappen uit om Azure Logic Apps AK2-segmenten te laten genereren voor geaccepteerde transactiesets waarbij AK501 == A is:
Open in de Azure Portal uw integratieaccount en open vervolgens het X12-overeenkomstartefact tussen uw X12-handelspartners.
Open het deelvenster Instellingen ontvangen en zorg ervoor dat FA Verwacht is geselecteerd. U kunt vervolgens AK2/IK2-lus opnemen selecteren.
AK3
Het optionele AK3-segment rapporteert fouten in een gegevenssegment en identificeert de locatie van het gegevenssegment. Er wordt een AK3-segment gemaakt voor elk segment in een transactieset met een of meer fouten. Als er meerdere AK3-segmenten bestaan, worden deze verzonden als een reeks lussen met één segment per lus. Het AK3-segment specificeert de locatie van elk segment met fouten en rapporteert het type syntactische fout dat op die locatie is gevonden met behulp van de volgende gegevenselementen:
| Element | Beschrijving |
|---|---|
| AK301 | Verplicht, identificeert het segment met de X12-segment-id, bijvoorbeeld NM1. |
| AK302 | Verplicht, identificeert het aantal segmenten van het segment in fout. Het ST-segment is 1, en elk segment neemt het aantal segmenten met één toe. |
| AK303 | Verplicht, identificeert een begrensde lus, een lus omgeven door een LS-segment (Lus starten) en een LE-segment (Loop End). AK303 bevat de waarden van de LS- en LE-segmenten die het segment per fout hebben gebonden. |
| AK304 | Optioneel, geeft de code voor de fout in het gegevenssegment op. Hoewel AK304 optioneel is, is het element vereist wanneer er een fout voor het geïdentificeerde segment bestaat. Raadpleeg 997 ACK-foutcodes - Gegevenssegmentnotitie voor AK304-foutcodes. |
AK4
Het optionele AK4-segment rapporteert fouten in een gegevenselement of samengestelde gegevensstructuur en identificeert de locatie van het gegevenselement. Een AK4-segment wordt verzonden wanneer het AK304-gegevenselement is "8", "Segment has data element errors" en kan maximaal 99 keer worden herhaald binnen elk AK3-segment. Het AK4-segment specificeert de locatie van elk gegevenselement of samengestelde gegevensstructuur met fouten en rapporteert het type syntactische fout dat op die locatie is gevonden met behulp van de volgende gegevenselementen:
| Element | Beschrijving |
|---|---|
| AK401 | Verplicht, een samengesteld gegevenselement met de volgende velden: AK41.1, AK41.2 en AK41.3 - AK401.1: Identificeert het gegevenselement of de samengestelde gegevensstructuur met behulp van het numerieke aantal. Als het tweede gegevenselement in het segment bijvoorbeeld een fout bevat, is AK401 gelijk aan |
| AK402 | Optioneel, identificeert het eenvoudige X12-gegevenselementnummer van het foutelement. NM101 is bijvoorbeeld het eenvoudige X12-gegevenselement nummer 98. |
| AK403 | Verplicht, rapporteert de fout van het geïdentificeerde element. Raadpleeg 997 ACK-foutcodes - Opmerking over gegevenselementen voor AK403-foutcodes. |
| AK404 | Optioneel, bevat een kopie van het geïdentificeerde gegevenselement in fout. AK404 wordt niet gebruikt als de fout een ongeldig teken aangeeft. |
AK5
Het AK5-segment rapporteert of de transactieset die is geïdentificeerd in het AK2-segment wordt geaccepteerd of geweigerd en waarom. Het AK5-segment is verplicht wanneer de optionele AK2-lus is opgenomen in de bevestiging. Het AK4-segment specificeert de status van de transactieset met behulp van één verplicht gegevenselement en biedt foutcodes met een tot vijf optionele gegevenselementen, op basis van de syntaxisbewerking van de transactieset.
| Element | Beschrijving |
|---|---|
| AK501 | Verplicht, geeft aan of de geïdentificeerde transactieset wordt geaccepteerd of geweigerd. Raadpleeg 997 ACK-foutcodes - Transaction Response Trailer voor AK501-foutcodes. |
| AK502 - AK506 | Optioneel, geeft de aard van de fout aan. Voor AK502-foutcodes raadpleegt u 997 ACK-foutcodes - Reactietrailer voor transactiesets. |
AK9
Het verplichte AK9-segment geeft aan of de functionele groep die in het AK1-segment is geïdentificeerd, wordt geaccepteerd of geweigerd en waarom. Het SEGMENT AK9 specificeert de status van de transactieset en de aard van een fout met behulp van vier verplichte gegevenselementen. Het segment specificeert eventuele genoteerde fouten met behulp van een tot vijf optionele elementen.
| Element | Beschrijving |
|---|---|
| AK901 | Verplicht, geeft aan of de functionele groep die is geïdentificeerd in AK1 wordt geaccepteerd of geweigerd. Raadpleeg 997 ACK-foutcodes - Functionele groepsreactietrailer voor AK901-foutcodes. |
| AK902 | Verplicht, geeft het aantal transactiesets op dat is opgenomen in de geïdentificeerde functionele groepstrailer (GE01). |
| AK903 | Verplicht, geeft het aantal ontvangen transactiesets op. |
| AK904 | Verplicht, geeft het aantal transactiesets op dat is geaccepteerd in de geïdentificeerde functionele groep. |
| AK905 - AK909 | Optioneel, geeft één tot vijf fouten aan die zijn genoteerd in de geïdentificeerde functionele groep. Raadpleeg 997 ACK-foutcodes - Antwoordtrailer voor functionele groepen voor foutcodes van AK905 naar AK909. |
997 ACK-foutcodes
In deze sectie worden de foutcodes behandeld die worden gebruikt in 997 ACK-segmenten. Elke tabel bevat de ondersteunde en niet-ondersteunde foutcodes, zoals gedefinieerd door de X12-specificatie, voor X12-berichtverwerking in Azure Logic Apps.
AK304-foutcodes - Gegevenssegmentnotitie
De volgende tabel bevat de foutcodes die worden gebruikt in het AK304-gegevenselement van het AK3-segment (opmerking gegevenssegment):
| Foutcode | Voorwaarde | Ondersteund? |
|---|---|---|
| 1 | Niet-herkende segment-id | Ja |
| 2 | Onverwacht segment | Ja |
| 3 | Verplicht segment ontbreekt | Ja |
| 4 | Lus vindt plaats gedurende maximumtijden | Ja |
| 5 | Segment overschrijdt het maximumgebruik | Ja |
| 6 | Segment niet in gedefinieerde transactieset | Ja |
| 7 | Segment niet in de juiste volgorde | Ja |
| 8 | Segment bevat fouten met gegevenselementen | Ja |
| 511 | Er zijn afsluitende scheidingstekens aangetroffen (aangepaste code) | Ja |
AK403-foutcodes - Opmerking gegevenselement
De volgende tabel bevat de foutcodes die worden gebruikt in het gegevenselement AK403 van het AK4-segment (opmerking voor gegevenselementen):
| Foutcode | Voorwaarde | Ondersteund? |
|---|---|---|
| 1 | Verplicht gegevenselement ontbreekt | Ja |
| 2 | Voorwaardelijk vereist gegevenselement ontbreekt | Ja |
| 3 | Te veel gegevenselementen | Ja |
| 4 | Het gegevenselement is te kort | Ja |
| 5 | Gegevenselement is te lang | Ja |
| 6 | Ongeldig teken in gegevenselement | Ja |
| 7 | Ongeldige codewaarde | Ja |
| 8 | Ongeldige datum | Ja |
| 9 | Ongeldige tijd | Ja |
| 10 | Uitsluitingsvoorwaarde geschonden | Ja |
AK501-foutcodes - Antwoordtrailer voor transactiesets
De volgende tabel bevat de foutcodes die worden gebruikt in het AK501-gegevenselement van het AK5-segment (Transaction Set Response Trailer):
| Foutcode | Voorwaarde | Ondersteund? |
|---|---|---|
| A | Geaccepteerd | Ja |
| E | Geaccepteerd, maar er zijn fouten genoteerd | Ja
Opmerking: geen foutcodes leiden tot de status |
| M | Geweigerd, berichtverificatiecode (MAC) is mislukt | Nee |
| P | Gedeeltelijk geaccepteerd, ten minste één transactieset is geweigerd | Ja |
| R | Afgewezen | Ja |
| W | Geweigerd, assurance mislukte geldigheidstests | Nee |
| X | Geweigerd, inhoud na ontsleuteling kan niet worden geanalyseerd | Nee |
AK502-naar-AK506-foutcodes - Reactietrailer voor transactiesets
De volgende tabel bevat de foutcodes die worden gebruikt in de gegevenselementen AK502 naar AK506 van het AK5-segment (Transaction Set Response Trailer):
| Foutcode | Voorwaarde | Ondersteund of gecorreleerd met AK501? |
|---|---|---|
| 1 | Transactieset wordt niet ondersteund | Ja, R |
| 2 | Aanhangwagen voor transactieset ontbreekt | Ja, R |
| 3 | Het controlenummer van de transactieset in de koptekst en de trailer komen niet overeen | Ja, R |
| 4 | Het aantal opgenomen segmenten komt niet overeen met het werkelijke aantal | Ja, R |
| 5 | Een of meer segmenten fout | Ja, R |
| 6 | Ontbrekende of ongeldige transactieset-id | Ja, R |
| 7 | Ontbrekend of ongeldig controlenummer voor transactiesets. Er is mogelijk een dubbel transactienummer opgetreden | Ja, R |
| 8 tot en met 27 | - | Nee |
AK901-foutcodes - Antwoordtrailer voor functionele groepen
De volgende tabel bevat de foutcodes die worden gebruikt in de AK901-gegevenselementen van het AK9-segment (Antwoordtrailer voor functionele groepen):
| Foutcode | Voorwaarde | Ondersteund of gecorreleerd met AK501? |
|---|---|---|
| A | Geaccepteerd | Ja |
| E | Geaccepteerd, maar er zijn fouten genoteerd | Ja |
| M | Geweigerd, berichtverificatiecode (MAC) is mislukt | Nee |
| P | Gedeeltelijk geaccepteerd, ten minste één transactieset is geweigerd | Ja |
| R | Afgewezen | Ja |
| W | Geweigerd, assurance mislukte geldigheidstests | Nee |
| X | Geweigerd, inhoud na ontsleuteling kan niet worden geanalyseerd | Nee |
AK905-naar-AK909-foutcodes - Antwoordtrailer voor functionele groepen
De volgende tabel bevat de foutcodes die worden gebruikt in de gegevenselementen AK905 tot AK909 van het AK9-segment (Antwoordtrailer voor functionele groepen):
| Foutcode | Voorwaarde | Ondersteund of gecorreleerd met AK501? |
|---|---|---|
| 1 | Functionele groep wordt niet ondersteund | Nee |
| 2 | Versie van functionele groep wordt niet ondersteund | Nee |
| 3 | Functionele groepstrailer ontbreekt | Ja |
| 4 | Groepsbeheernummer in de header en trailer van de functionele groep komen niet overeen | Ja |
| 5 | Het aantal opgenomen transactiesets komt niet overeen met het werkelijke aantal | Ja |
| 6 | Het groepsbeheernummer is in strijd met de syntaxis, er kan een dubbel groepsbeheernummer zijn opgetreden | Ja |
| 7 tot 26 | - | Nee |