Condividi tramite


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:

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:

  1. Nella portale di Azure aprire l'account di integrazione e quindi aprire l'artefatto del contratto X12 tra i partner commerciali X12.

  2. 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 2a .
AK401.2: identifica il conteggio numerico dell'elemento dati del componente in una struttura di dati composita con errore. Quando AK401 segnala un errore in una struttura di dati non composita, AK401.2 non viene valore.
- AK41.3: Facoltativo, questo campo è la posizione dell'elemento dati ripetuto. AK41.3 supporta in ingresso 5010 conforme a 997.

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
2 Segmento imprevisto
3 Manca un segmento obbligatorio
4 Numero massimo di occorrenze del ciclo superato
5 Utilizzo massimo segmento superato
6 Segmento non incluso nel set di transazioni definito
7 Segmento in sequenza non corretta
8 Elementi dati con errori nel segmento
511 Rilevati separatori finali (codice personalizzato)

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
2 Manca l'elemento dati condizionale obbligatorio
3 Troppi elementi dati
4 Elemento dati troppo corto
5 Elemento dati troppo lungo
6 Carattere non valido nell'elemento dati
7 Valore di codice non valido
8 Data non valida
9 Ora non valida
10 Condizione di esclusione violata

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
E Accettato, ma sono stati riscontrati errori

Nota: nessun codice di errore porta a uno stato di E.

M Rifiutato, Message Authentication Code (MAC) non riuscito No
P Parzialmente accettato, almeno un set di transazioni è stato rifiutato
R Rifiutato
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
E Accettato, ma sono stati riscontrati errori
M Rifiutato, Message Authentication Code (MAC) non riuscito No
P Parzialmente accettato, almeno un set di transazioni è stato rifiutato
R Rifiutato
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
4 Mancata corrispondenza del numero di controllo nell'intestazione e nel trailer del gruppo funzionale
5 Mancata corrispondenza tra il numero di set di transazioni inclusi e il numero effettivo
6 Il numero di controllo del gruppo viola la sintassi, è possibile che si sia verificato un numero di controllo gruppo duplicato
da 7 a 26 - No

Passaggi successivi