Compartir a través de


Confirmaciones funcionales 997 y códigos de error de los mensajes X12 en Azure Logic Apps

Se aplica a: Azure Logic Apps (consumo + estándar)

En Azure Logic Apps, puede crear flujos de trabajo que controlen los mensajes X12 para la comunicación del intercambio electrónico de datos (EDI) al usar las operaciones X12. En la mensajería EDI, las confirmaciones proporcionan el estado del procesamiento de un intercambio EDI. Al recibir un intercambio, la acción Descodificación de X12 puede devolver uno o varios tipos de confirmaciones al emisor, en función de los tipos de confirmación que estén habilitados y el nivel de validación especificado.

Por ejemplo, el receptor notifica el estado de la validación del encabezado de grupo funcional (GS) y el finalizador de grupo funcional (GE) en el mensaje con código X12 recibido mediante el envío de una confirmación funcional (ACK) 997, junto con cada error que se produce durante el procesamiento. La acción Descodificación de X12 siempre genera confirmaciones ACK 997 compatibles con 4010, mientras que las acciones Codificación de X12 y Descodificación de X12 pueden validar confirmaciones ACK 997 compatibles con 5010.

El receptor envía confirmaciones ACK 997 dentro de un sobre de encabezado de grupo funcional (GS) y finalizador de grupo funcional (GE). Sin embargo, este sobre no es diferente de que el de cualquier otro conjunto de transacciones.

En este tema se proporciona una breve información general sobre las confirmaciones ACK 997 de X12, incluidos los segmentos ACK 997 de un intercambio y los códigos de error que se usan en esos segmentos. Para obtener información relacionada, consulte la siguiente documentación:

Segmentos ACK 997

En la tabla siguiente se describen los segmentos ACK 997 de un intercambio y se utilizan las definiciones siguientes:

  • M = Obligatorio
  • O = Opcional
Posición Id. de segmento Nombre Designación necesaria
(Req. Des.)
Uso máximo Repetición de bucle
010 ST Encabezado del conjunto de transacciones, para la confirmación M 1 -
020 AK1 Encabezado de respuesta de grupo funcional M 1 -
030 AK2 Encabezado de respuesta de conjunto de transacciones O 1 999999
(Id. de bucle = AK2)
040 AK3 Nota del segmento de datos O 1 999999
(Id. de bucle = AK2 o AK3)
050 AK4 Nota del elemento de datos O 9 9 -
060 AK5 Finalizador de respuesta de conjunto de transacciones M 1 -
070 AK9 Finalizador de respuesta de grupo funcional M 1 -
080 SE Finalizador del conjunto de transacciones, para la confirmación M 1 -

En las secciones siguientes se proporciona más información sobre cada uno de los segmentos AK. En el bucle AK2 a AK5, los segmentos proporcionan información acerca de un error con un conjunto de transacciones.

AK1

El segmento AK1 obligatorio identifica el grupo funcional que se va a confirmar mediante los siguientes elementos de datos:

Elemento Descripción
AK101 Obligatorio, identifica el identificador de grupo funcional (GS01) que el grupo funcional debe confirmar.
AK102 Obligatorio, identifica el número de control del grupo (GS06 y GE02) que el grupo funcional debe confirmar.
AK103 Opcional, identifica la versión de implementación de EDI enviada en el GS08 de la transacción original. AK103 admite una confirmación de entrada ACK 997 compatible con 5010.

AK2

El segmento AK2 opcional contiene una confirmación de un conjunto de transacciones en el grupo funcional recibido. Si existen varios segmentos AK2, se envían como una serie de bucles. Cada bucle de AK2 identifica un conjunto de transacciones según el orden de recepción. Si un conjunto de transacciones genera un error, un bucle de AK2 contendrá segmentos AK3, AK4 y AK5. Para obtener más información, examine las descripciones de los segmentos en este mismo tema.

El segmento AK2 identifica el conjunto de transacciones mediante los siguientes elementos de datos:

Elemento Descripción
AK201 Obligatorio, especifica el identificador del conjunto de transacciones (ST01) que se debe confirmar.
AK202 Obligatorio, identifica el número de control (ST02 y SE02) del conjunto de transacciones que se debe confirmar.
AK203 Opcional, identifica la versión de implementación de EDI enviada en el ST03 de la transacción original. AK203 admite confirmaciones de entrada 997 compatibles con 5010.

Generación de segmentos AK2

Puede especificar que se generen segmentos AK2 para todos los conjuntos de transacciones, aceptados y rechazados, o bien solo para los conjuntos de transacciones rechazados. En caso contrario, Azure Logic Apps generará bucles AK2 solo para los conjuntos de transacciones rechazados. Si no se resuelve un acuerdo para el intercambio al que se está respondiendo, la configuración de la generación de 997 toma de forma predeterminada el valor de la configuración del acuerdo de reserva y no se generan segmentos AK2 para los conjuntos de transacciones aceptados.

Para que Azure Logic Apps genere segmentos AK2 para los conjuntos de transacciones aceptados donde AK501 == A, siga estos pasos:

  1. En Azure Portal, abra su cuenta de integración y, después, abra el artefacto del contrato X12 entre sus entidades X12.

  2. Abra el panel Configuración de recepción y asegúrese de que FA esperada aparece seleccionada. Luego, puede seleccionar Incluir bucle AK2/IK2.

AK3

El segmento AK3 opcional genera informes de errores en un segmento de datos e identifica la ubicación del segmento de datos. Se crea un segmento AK3 para cada segmento de un conjunto de transacciones que tenga uno o varios errores. Si existen varios segmentos AK3, se envían como una serie de bucles con un segmento por bucle. El segmento AK3 especifica la ubicación de los segmentos que contienen errores y genera informes del tipo de error sintáctico encontrado en dicha ubicación mediante los siguientes elementos de datos:

Elemento Descripción
AK301 Obligatorio, identifica el segmento que contiene el error con el Id. de segmento X12, por ejemplo, NM1.
AK302 Obligatorio, identifica el número de segmentos del segmento que contiene el error. El segmento ST es 1 y cada uno de los segmentos aumenta el número de segmentos en uno.
AK303 Obligatorio, identifica un bucle delimitado, que es un bucle rodeado por un segmento de inicio de bucle (LS) y un segmento de fin de bucle (LE). AK303 contiene los valores de los segmentos LS y LE que enlazan el segmento que contiene el error.
AK304 Opcional, especifica el código del error del segmento de datos. Aunque AK304 es opcional, el elemento es necesario cuando existe un error en el segmento identificado. En el caso de los códigos de error de AK304, revise 997 ACK error codes - Data Segment Note (Códigos de error ACK 997: nota del segmento de datos).

AK4

El segmento AK4 opcional informa de errores en un elemento de datos o en la estructura de datos compuesta e identifica la ubicación del elemento de datos. Cuando el elemento de datos AK304 es "8", "Segment has data element errors" se envía un segmento AK4 y puede repetirse hasta 99 veces dentro de cada segmento de AK3. El segmento AK4 especifica la ubicación de los elementos de datos o la estructura de datos compuesta que contiene errores e informa del tipo de error sintáctico encontrado en dicha ubicación mediante los siguientes elementos de datos:

Elemento Descripción
AK401 Obligatorio, un elemento de datos compuesto con los siguientes campos: AK41.1, AK41.2 y AK41.3

- AK401-1: identifica el elemento de datos o la estructura de datos compuesta que contienen un error mediante su recuento numérico. Por ejemplo, si el segundo elemento de datos del segmento tiene un error, AK401 es igual a 2.
AK401-2: identifica el recuento numérico del elemento de datos del componente de una estructura de datos compuesta que tiene un error. Si AK401 informa de un error en una estructura de datos que no es compuesta, no se ha especificado valor para AK401.2.
- AK41.3: opcional, este campo es la posición del elemento de datos que se repite. AK41.3 admite 5010 de entrada compatible con 997.

AK402 Opcional, identifica el número simple del elemento de datos X12 del elemento que contiene el error. Por ejemplo, NM101 es el número 98 del elemento de datos X12 simple.
AK403 Obligatorio, informa del error del elemento identificado. En el caso de los códigos de error de AK403, revise 997 ACK error codes - Data Element Note (Códigos de error ACK 997: nota del elemento de datos).
AK404 Opcional, contiene una copia de elemento de datos identificado que contiene el error. AK404 no se utiliza si el error indica un carácter no válido.

AK5

El segmento AK5 indica si el conjunto de transacciones identificado en el segmento AK2 se identifica o se rechaza y el motivo. El segmento AK5 es obligatorio cuando el bucle AK2 opcional se incluye en la confirmación. El segmento AK4 especifica el estado del conjunto de transacciones mediante un único elemento de datos obligatorio y proporciona códigos de error mediante entre uno y cinco elementos de datos opcionales, en función en la sintaxis que edita el conjunto de transacciones.

Elemento Descripción
AK501 Obligatorio, especifica si se acepta o rechaza el conjunto de transacciones identificado. En el caso de los códigos de error de AK501, consulte 997 ACK error codes - Transaction Response Trailer (Códigos de error ACK 997: finalizador de respuesta de transacción).
AK502 - AK506 Opcional, indique la naturaleza del error. En el caso de los códigos de error de AK502, consulte 997 ACK error codes - Transaction Set Response Trailer (Códigos de error ACK 997: finalizador de respuesta del conjunto de transacciones).

AK9

El segmento AK9 obligatorio indica si el grupo funcional identificado en el segmento AK1 se acepta o se rechaza y el motivo. El segmento AK9 especifica el estado del conjunto de transacciones y la naturaleza de cualquier error mediante cuatro elementos de datos obligatorios. El segmento especifica los errores anotados mediante el uso de entre uno y cinco elementos opcionales.

Elemento Descripción
AK901 Obligatorio, especifica si se acepta o se rechaza el grupo funcional identificado en AK1. En el caso de los códigos de error de AK901, consulte 997 ACK error codes - Functional Group Response Trailer (Códigos de error ACK 997: finalizador de respuesta de grupo funcional).
AK902 Obligatorio, especifica el número de conjuntos de transacciones incluido en el finalizador del grupo funcional identificado (GE01).
AK903 Obligatorio, especifica el número de conjuntos de transacciones recibidos.
AK904 Obligatorio, especifica el número de conjuntos de transacciones aceptado en el grupo funcional identificado.
AK905 - AK909 Opcional, indica de uno a cinco errores anotados en el grupo funcional identificado. En el caso de los códigos de error de AK905 a AK909, consulte 997 ACK error codes - Functional Group Response Trailer (Códigos de error ACK 997: finalizador de respuesta de grupo funcional).

Códigos de error de ACK 997

En esta sección se tratan los códigos de error que se usan en los segmentos ACK 997. En cada tabla se enumeran los códigos de error admitidos y no admitidos, tal como se define en la especificación X12, para el procesamiento de mensajes X12 en Azure Logic Apps.

Códigos de error de AK304: nota del segmento de datos

La tabla siguiente muestra los códigos de error que se utilizan en el elemento de datos AK304 del segmento AK3 (nota del segmento de datos):

Código de error Condición ¿Compatible?
1 Id. de segmento no reconocido.
2 Segmento inesperado.
3 Falta segmento obligatorio
4 Repetición de bucles superior al máximo permitido
5 El segmento excede la descripción de uso máximo
6 Segmento no definido en el conjunto de transacciones
7 El segmento no tiene el orden adecuado
8 El segmento contiene errores de elementos de datos
511 Se han encontrado separadores finales (código personalizado)

Códigos de error de AK403: nota del elemento de datos

En la tabla siguiente se enumeran los códigos de error que se utilizan en el elemento de datos AK403 del segmento AK4 (nota del elemento de datos):

Código de error Condición ¿Compatible?
1 Falta elemento de datos obligatorio.
2 Falta un elemento de datos requerido condicional.
3 Demasiados elementos de datos.
4 El elemento de datos es demasiado corto.
5 El elemento de datos es demasiado largo.
6 Carácter no válido en el elemento de datos.
7 Valor de código no válido
8 Fecha no válida
9 Hora no válida
10 Infracción de la condición de exclusión

Códigos de error de AK501: finalizador de respuesta del conjunto de transacciones

En la tabla siguiente se enumeran los códigos de error que se utilizan en el elemento de datos AK501 del segmento AK5 (finalizador de respuesta del conjunto de transacciones):

Código de error Condición ¿Compatible?
A Aceptado
E Se acepta, pero se registraron los errores.

Nota: ninguno de los códigos de error conduce al estado E.

M Rechazado. Error del código de autenticación del mensaje (MAC). No
P Parcialmente aceptado, pero al menos un conjunto de transacciones se rechazó.
R Rechazada
W Rechazado. La seguridad no superó las pruebas de validez. No
X Rechazado. No se pudo analizar el contenido tras el descifrado. No

Códigos de error de AK502 a AK506: finalizador de respuesta del conjunto de transacciones

La tabla siguiente muestra los códigos de error que se utilizan en los elementos de datos de AK502 a AK506 del segmento AK5 (finalizador de respuesta del conjunto de transacciones):

Código de error Condición ¿Compatible o
correlacionado con AK501?
1 Conjunto de transacciones no admitido Sí, R
2 Falta el finalizador de conjunto de transacciones. Sí, R
3 El número de control de conjunto de transacciones del encabezado y del finalizador no coincide. Sí, R
4 El número de segmentos incluidos no coincide con el recuento real. Sí, R
5 Error en uno o más segmentos. Sí, R
6 El identificador del conjunto de transacciones falta o no es válido. Sí, R
7 El número de control del conjunto de transacciones falta o no es válido, puede haberse producido la duplicación de un número de transacción. Sí, R
8 a 27 - No

Códigos de error de AK901: finalizador de respuesta de grupo funcional

En la tabla siguiente se enumeran los códigos de error que se utilizan en los elementos de datos AK901 del segmento AK9 (finalizador de respuesta del grupo funcional):

Código de error Condición ¿Compatible o
correlacionado con AK501?
A Aceptado
E Se acepta, pero se registraron los errores.
M Rechazado. Error del código de autenticación del mensaje (MAC). No
P Parcialmente aceptado, pero al menos un conjunto de transacciones se rechazó.
R Rechazada
W Rechazado. La seguridad no superó las pruebas de validez. No
X Rechazado. No se pudo analizar el contenido tras el descifrado. No

Códigos de error de AK905 a AK909: finalizador de respuesta de grupo funcional

En la tabla siguiente se enumeran los códigos de error que se utilizan en los elementos de datos de AK905 a AK909 del segmento AK9 (finalizador de respuesta del grupo funcional):

Código de error Condición ¿Compatible o
correlacionado con AK501?
1 Grupo funcional no compatible No
2 Versión de grupo funcional no compatible No
3 Falta el finalizador del grupo funcional.
4 El número de control de grupo del encabezado y el finalizador del grupo funcional no coinciden.
5 El número de conjuntos de transacciones incluidos no coincide con el recuento real.
6 El número de control de grupo infringe la sintaxis, puede haberse producido la duplicación de un número de control de grupo.
7 a 26 - No

Pasos siguientes