997 riconoscimenti funzionali e codici di errore per i messaggi X12 in App per la logica di Azure
Si applica a: App per la logica di Azure (consumo + Standard)
In App per la logica di Azure è possibile creare flussi di lavoro che gestiscono messaggi X12 per la comunicazione EDI (Electronic Data Interchange) quando si usano operazioni X12 . Nella messaggistica EDI, i riconoscimenti forniscono lo stato dall'elaborazione di un interscambio EDI. Quando si riceve un interscambio, l'azione decodifica X12 può restituire uno o più tipi di riconoscimenti al mittente, in base ai tipi di riconoscimento abilitati e al livello di convalida specificato.
Ad esempio, il ricevitore segnala lo stato dalla convalida dell'intestazione del gruppo funzionale (GS) e del trailer del gruppo funzionale (GE) nel messaggio con codifica X12 ricevuta inviando un riconoscimento funzionale 997 (ACK ) insieme a ogni errore che si verifica durante l'elaborazione. L'azione di decodifica X12 genera sempre un ACK conforme a 4010, mentre l'azione Codifica X12 e X12Decode può convalidare un ACK conforme a 5010.
Il ricevitore invia il 997 ACK all'interno di un'intestazione del gruppo funzionale (GS) e una busta del trailer del gruppo funzionale (GE). Tuttavia, questa busta GS e GE non è diversa da qualsiasi altro set di transazioni.
In questo argomento viene fornita una breve panoramica sull'ACK X12 997, inclusi i segmenti ACK 997 in un interscambio e sui codici di errore usati in tali segmenti. Per altre informazioni correlate, vedere la documentazione seguente:
- Riconoscimento tecnico X12 TA1 e codici di errore
- Messaggi di Exchange X12 per l'integrazione aziendale B2B
- Messaggi EDIFACT di Exchange per l'integrazione aziendale B2B
- Informazioni su App per la logica di Azure
- Soluzioni di integrazione aziendale B2B con App per la logica di Azure ed Enterprise Integration Pack
997 segmenti ACK
La tabella seguente descrive i segmenti ACK 997 in un interscambio e usa le definizioni seguenti:
- O = Obbligatorio
- F = Facoltativo
| Position | ID segmento | Nome | Designazione obbligatoria (Req. Des.) |
Utilizzo massimo | Ripetizione ciclo |
|---|---|---|---|---|---|
| 010 | ST | Intestazione set di transazioni per il riconoscimento | M | 1 | - |
| 020 | AK1 | Intestazione risposta gruppo funzionale | M | 1 | - |
| 030 | AK2 | Intestazione risposta set transazioni | O | 1 | 999999 (ID ciclo = AK2) |
| 040 | AK3 | Nota segmento dati | O | 1 | 999999 (ID ciclo = AK2 o AK3) |
| 050 | AK4 | Nota elemento dati | O | 9 9 | - |
| 060 | AK5 | Trailer risposta set transazioni | M | 1 | - |
| 070 | AK9 | Trailer risposta gruppo funzionale | M | 1 | - |
| 080 | SE | Trailer set di transazioni, per il riconoscimento | M | 1 | - |
Le sezioni seguenti forniscono altre informazioni su ogni segmento AK. Nel ciclo AK2 a AK5 i segmenti forniscono informazioni su un errore con un set di transazioni.
AK1
Il segmento AK1 obbligatorio identifica il gruppo funzionale da riconoscere usando gli elementi di dati seguenti:
| Elemento | Descrizione |
|---|---|
| AK101 | Obbligatorio, identifica l'ID gruppo funzionale (GS01) per il gruppo funzionale da riconoscere. |
| AK102 | Obbligatorio, identifica il numero di controllo del gruppo (GS06 e GE02) per il gruppo funzionale da riconoscere. |
| AK103 | Facoltativo, identifica la versione di implementazione EDI inviata in GS08 dalla transazione originale. AK103 supporta un ACK conforme a 5010 conforme a 5010. |
AK2
Il segmento AK2 facoltativo contiene un riconoscimento per un set di transazioni nel gruppo funzionale ricevuto. Se esistono più segmenti AK2, vengono inviati come serie di cicli. Ogni ciclo AK2 identifica un set di transazioni usando l'ordine ricevuto. Se un set di transazioni è in errore, un ciclo AK2 contiene segmenti AK3, AK4 e AK5. Per altre informazioni, vedere le descrizioni dei segmenti più avanti in questo argomento.
Il segmento AK2 identifica il set di transazioni usando gli elementi di dati seguenti:
| Elemento | Descrizione |
|---|---|
| AK201 | Obbligatorio, identifica l'ID del set di transazioni (ST01) del set di transazioni da riconoscere. |
| AK202 | Obbligatorio, identifica il numero di controllo del set di transazioni (ST02 e SE02) del set di transazioni da riconoscere. |
| AK203 | Facoltativo, identifica la versione di implementazione EDI inviata nel ST03 della transazione originale. AK203 supporta in ingresso 5010 conforme a 997. |
Generare segmenti AK2
È possibile specificare che i segmenti AK2 vengono generati per tutti i set di transazioni accettati e rifiutati o solo per i set di transazioni rifiutati. In caso contrario, App per la logica di Azure genera cicli AK2 solo per i set di transazioni rifiutati. Se un contratto non si risolve per l'interscambio a cui viene risposto, le impostazioni di generazione 997 predefinite per le impostazioni del contratto di fallback e i segmenti AK2 non vengono generati per i set di transazioni accettati.
Per avere App per la logica di Azure generare segmenti AK2 per set di transazioni accettati in cui AK501 == A, seguire questa procedura:
Nella portale di Azure aprire l'account di integrazione e quindi aprire l'artefatto del contratto X12 tra i partner commerciali X12.
Aprire il riquadro Impostazioni di ricezione , assicurarsi che venga visualizzata l'opzione Fa Expected selezionata. È quindi possibile selezionare Includi ciclo AK2/IK2.
AK3
Il segmento AK3 facoltativo indica gli errori in un segmento dati e identifica la posizione del segmento dati. Viene creato un segmento AK3 per ogni segmento contenuto in un set di transazioni con uno o più errori. Se esistono più segmenti AK3, vengono inviati come serie di cicli con un segmento per ciclo. Il segmento AK3 specifica la posizione di ogni segmento in errore e segnala il tipo di errore sintattico trovato in tale posizione usando gli elementi di dati seguenti:
| Elemento | Descrizione |
|---|---|
| AK301 | Obbligatorio, identifica il segmento in errore con l'ID segmento X12, ad esempio NM1. |
| AK302 | Obbligatorio, identifica il numero di segmenti del segmento in errore. Il segmento ST è 1e ogni segmento incrementa il conteggio dei segmenti per uno. |
| AK303 | Obbligatorio, identifica un ciclo delimitato, che è un ciclo circondato da un segmento Ciclo Start (LS) e un segmento Loop End (LE). AK303 contiene i valori dei segmenti LS e LE che vincolano il segmento in errore. |
| AK304 | Facoltativo, specifica il codice per l'errore nel segmento di dati. Anche se AK304 è facoltativo, l'elemento è necessario quando esiste un errore per il segmento identificato. Per i codici di errore AK304, vedere 997 codici di errore ACK - Nota segmento dati. |
AK4
Il segmento facoltativo AK4 indica gli errori in un elemento dati o in una struttura di dati composita e identifica la posizione dell'elemento dati. Viene inviato un segmento AK4 quando l'elemento dati AK304 è "8", "Segment has data element errors" e può ripetere fino a 99 volte all'interno di ogni segmento AK3. Il segmento AK4 specifica la posizione di ogni elemento dati o struttura di dati composita nell'errore e segnala il tipo di errore sintattico trovato in tale posizione usando gli elementi di dati seguenti:
| Elemento | Descrizione |
|---|---|
| AK401 | Obbligatorio, un elemento dati composito con i campi seguenti: AK41.1, AK41.2 e AK41.3 - AK401.1: identifica l'elemento dati o la struttura di dati composita in errore usando il conteggio numerico. Ad esempio, se il secondo elemento di dati nel segmento ha un errore, AK401 è uguale |
| AK402 | Facoltativo, identifica il numero di elemento dati X12 semplice dell'elemento in errore. Ad esempio, NM101 è il numero di elemento dati X12 semplice 98. |
| AK403 | Obbligatorio, segnala l'errore dell'elemento identificato. Per i codici di errore AK403, vedere 997 codici di errore ACK - Nota elemento dati. |
| AK404 | Facoltativo, contiene una copia dell'elemento dati identificato in caso di errore. Non viene utilizzato se l'errore indica un carattere non valido. |
AK5
Il segmento AK5 indica se il set di transazioni identificato nel segmento AK2 è accettato o rifiutato e ne specifica il motivo. Il segmento AK5 è obbligatorio quando il ciclo AK2 facoltativo è incluso nel riconoscimento. Il segmento AK4 specifica lo stato del set di transazioni usando un singolo elemento dati obbligatorio e fornisce codici di errore usando tra uno e cinque elementi dati facoltativi, in base alla modifica della sintassi del set di transazioni.
| Elemento | Descrizione |
|---|---|
| AK501 | Obbligatorio, specifica se il set di transazioni identificato viene accettato o rifiutato. Per i codici di errore AK501, vedere 997 codici di errore ACK - Trailer risposta transazione. |
| AK502 - AK506 | Facoltativo, indicare la natura dell'errore. Per i codici di errore AK502, vedere 997 codici di errore ACK - Trailer risposta set di transazioni. |
AK9
Il segmento obbligatorio AK9 indica se il gruppo funzionale identificato nel segmento AK1 è accettato o rifiutato e ne specifica il motivo. Il segmento AK9 specifica lo stato del set di transazioni e la natura di qualsiasi errore usando quattro elementi dati obbligatori. Il segmento specifica eventuali errori annotati usando tra uno e cinque elementi facoltativi.
| Elemento | Descrizione |
|---|---|
| AK901 | Obbligatorio, specifica se il gruppo funzionale identificato in AK1 è accettato o rifiutato. Per i codici di errore AK901, vedere 997 codici di errore ACK - Trailer risposta gruppo funzionale. |
| AK902 | Obbligatorio, specifica il numero di set di transazioni inclusi nel trailer del gruppo funzionale identificato (GE01). |
| AK903 | Obbligatorio, specifica il numero di set di transazioni ricevuti. |
| AK904 | Obbligatorio, specifica il numero di set di transazioni accettati nel gruppo funzionale identificato. |
| AK905 - AK909 | Facoltativo, indica da uno a cinque errori annotati nel gruppo funzionale identificato. Per aK905 a AK909 codici di errore, vedere 997 codici di errore ACK - Trailer risposta gruppo funzionale. |
997 Codici di errore ACK
Questa sezione illustra i codici di errore usati in 997 segmenti ACK. Ogni tabella elenca i codici di errore supportati e non supportati, come definito dalla specifica X12, per l'elaborazione dei messaggi X12 in App per la logica di Azure.
Codici di errore AK304 - Nota segmento dati
Nella tabella seguente sono elencati i codici di errore usati nell'elemento dati AK304 del segmento AK3 (Nota segmento di dati):
| Codice di errore | Condizione | Supportata |
|---|---|---|
| 1 | ID segmento non riconosciuto | Sì |
| 2 | Segmento imprevisto | Sì |
| 3 | Manca un segmento obbligatorio | Sì |
| 4 | Numero massimo di occorrenze del ciclo superato | Sì |
| 5 | Utilizzo massimo segmento superato | Sì |
| 6 | Segmento non incluso nel set di transazioni definito | Sì |
| 7 | Segmento in sequenza non corretta | Sì |
| 8 | Elementi dati con errori nel segmento | Sì |
| 511 | Rilevati separatori finali (codice personalizzato) | Sì |
Codici di errore AK403 - Nota elemento dati
Nella tabella seguente sono elencati i codici di errore usati nell'elemento dati AK403 del segmento AK4 (Nota elemento dati):
| Codice di errore | Condizione | Supportata |
|---|---|---|
| 1 | Manca un elemento dati obbligatorio | Sì |
| 2 | Manca l'elemento dati condizionale obbligatorio | Sì |
| 3 | Troppi elementi dati | Sì |
| 4 | Elemento dati troppo corto | Sì |
| 5 | Elemento dati troppo lungo | Sì |
| 6 | Carattere non valido nell'elemento dati | Sì |
| 7 | Valore di codice non valido | Sì |
| 8 | Data non valida | Sì |
| 9 | Ora non valida | Sì |
| 10 | Condizione di esclusione violata | Sì |
Codici di errore AK501 - Trailer della risposta del set di transazioni
Nella tabella seguente sono elencati i codici di errore usati nell'elemento dati AK501 del segmento AK5 (Transaction Set Response Trailer):
| Codice di errore | Condizione | Supportata |
|---|---|---|
| A | Accettato | Sì |
| E | Accettato, ma sono stati riscontrati errori | Sì Nota: nessun codice di errore porta a uno stato di |
| M | Rifiutato, Message Authentication Code (MAC) non riuscito | No |
| P | Parzialmente accettato, almeno un set di transazioni è stato rifiutato | Sì |
| R | Rifiutato | Sì |
| W | Rifiutato, test di validità non riusciti nella verifica | No |
| X | Rifiutato, impossibile analizzare il contenuto dopo la decrittografia | No |
Codici di errore da AK502 a AK506 - Trailer della risposta del set di transazioni
Nella tabella seguente sono elencati i codici di errore usati negli elementi di dati AK502 a AK506 del segmento AK5 (Transaction Set Response Trailer):
| Codice di errore | Condizione | Supportato o correlato a AK501? |
|---|---|---|
| 1 | Set di transazioni non supportato | Sì, R |
| 2 | Trailer set di transazioni mancante | Sì, R |
| 3 | Mancata corrispondenza del numero di controllo del set di transazioni nell'intestazione e nel trailer | Sì, R |
| 4 | Mancata corrispondenza tra il numero di segmenti inclusi e il numero effettivo | Sì, R |
| 5 | Uno o più segmenti con errori | Sì, R |
| 6 | Identificatore del set di transazioni mancante o non valido | Sì, R |
| 7 | Numero di controllo del set di transazioni mancante o non valido. È possibile che si sia verificato un numero di transazione duplicato | Sì, R |
| Da 8 a 27 | - | No |
Codici di errore AK901 - Trailer risposta gruppo funzionale
La tabella seguente elenca i codici di errore usati negli elementi dati AK901 del segmento AK9 (Functional Group Response Trailer):
| Codice di errore | Condizione | Supportato o correlato a AK501? |
|---|---|---|
| A | Accettato | Sì |
| E | Accettato, ma sono stati riscontrati errori | Sì |
| M | Rifiutato, Message Authentication Code (MAC) non riuscito | No |
| P | Parzialmente accettato, almeno un set di transazioni è stato rifiutato | Sì |
| R | Rifiutato | Sì |
| W | Rifiutato, test di validità non riusciti nella verifica | No |
| X | Rifiutato, impossibile analizzare il contenuto dopo la decrittografia | No |
Codici di errore da AK905 a AK909 - Trailer della risposta del gruppo funzionale
La tabella seguente elenca i codici di errore usati negli elementi di dati AK905 a AK909 del segmento AK9 (Functional Group Response Trailer):
| Codice di errore | Condizione | Supportato o correlato a AK501? |
|---|---|---|
| 1 | Gruppo funzionale non supportato | No |
| 2 | Versione del gruppo funzionale non supportata | No |
| 3 | Trailer del gruppo funzionale mancante | Sì |
| 4 | Mancata corrispondenza del numero di controllo nell'intestazione e nel trailer del gruppo funzionale | Sì |
| 5 | Mancata corrispondenza tra il numero di set di transazioni inclusi e il numero effettivo | Sì |
| 6 | Il numero di controllo del gruppo viola la sintassi, è possibile che si sia verificato un numero di controllo gruppo duplicato | Sì |
| da 7 a 26 | - | No |