Compartir vía


Referencia de la configuración de mensajes X12 en contratos para Azure Logic Apps

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

Esta referencia describe las propiedades que puede establecer en un contrato X12 para especificar cómo administrar los mensajes entre asociados comerciales. Configure estas propiedades en función del contrato con el asociado con el que intercambia mensajes.

Configuración de recepción X12

Captura de pantalla que muestra Azure Portal y la configuración del contrato X12 para los mensajes entrantes.

Identificadores

Propiedad Descripción
ISA1 (calificador de autorización) Valor del calificador de autorización que quiere usar. El valor predeterminado es 00 - No existe información de autorización.

Nota: Si selecciona otros valores, especifique un valor para la propiedad ISA2.
ISA2 Valor de la información de autorización que se usará cuando la propiedad ISA1 no esté definida como 00 - No existe información de autorización. Este valor de propiedad debe tener un carácter alfanumérico como mínimo y 10 como máximo.
ISA3 (calificador de seguridad) Valor del calificador de seguridad que quiere usar. El valor predeterminado es 00 - No existe información de seguridad.

Nota: Si selecciona otros valores, especifique un valor para la propiedad ISA4.
ISA4 Valor de la información de seguridad que se usará cuando la propiedad ISA3 no esté definida como 00 - No existe información de seguridad. Este valor de propiedad debe tener un carácter alfanumérico como mínimo y 10 como máximo.

Acknowledgement (Confirmación)

Propiedad Descripción
TA1 esperada Devuelva una confirmación técnica (TA1) al remitente del intercambio.
FA esperada Devuelva una confirmación funcional (FA) al remitente del intercambio.

Para la propiedad Versión de FA, en función de la versión de esquema, seleccione la confirmación 997 o 999.

Para activar la generación de bucles AK2 en confirmaciones funcionales para conjuntos de transacciones aceptados, seleccione Incluir bucle AK2/IK2.

Esquemas

En esta sección, seleccione un esquema de la cuenta de integración para cada tipo de transacción (ST01) y aplicación de remitentes (GS02). La canalización de recepción de EDI desensambla el mensaje entrante haciendo coincidir los valores y el esquema que defina en esta sección con los valores de ST01 y GS02 del mensaje entrante y con el esquema del mensaje entrante. Después de completar cada fila, aparece una fila vacía automáticamente.

Propiedad Descripción
Versión Versión X12 para el esquema.
Tipo de transacción (ST01) Tipo de transacción
Aplicación de remitentes (GS02) Aplicación de remitentes
Esquema Archivo de esquema que quiere usar

Sobres

Propiedad Descripción
Uso de ISA11 Separador que se va a usar en un conjunto de transacciones:

- Identificador estándar: Use un punto (.) para la notación decimal, en lugar de la notación decimal del documento entrante de la canalización de recepción de EDI.

- Separador de repeticiones: Especifique el separador para las repeticiones de un elemento de datos simple o una estructura de datos repetida. Por ejemplo, normalmente se utiliza el acento circunflejo (^) como separador de repeticiones. En los esquemas HIPAA, solo se puede usar el acento circunflejo.

Control Numbers (Números de control)

Propiedad Descripción
No permitir duplicados en números de control de intercambio Bloquee los intercambios duplicados. Compruebe el número de control de intercambio (ISA13) para el número de control de intercambio recibido. Si se detecta una coincidencia, la canalización de recepción de EDI no procesa el intercambio.



Para especificar el número de días para realizar la comprobación, especifique un valor para la propiedad Comprobar si hay ISA13 duplicados todos los (días) .
No permitir duplicados en números de control de grupo Bloquee los intercambios que tienen números de control de grupo duplicados.
No permitir duplicados en números de control de conjuntos de transacciones Bloquee los intercambios que tengan números de control de conjunto de transacciones duplicados.

Validaciones

La fila predeterminada muestra las reglas de validación que se usan para un tipo de mensaje de EDI. Si quiere definir otras reglas, seleccione cada uno de los cuadros en los que quiera definir el conjunto de reglas como true. Después de completar cada fila, aparece una fila vacía automáticamente.

Propiedad Descripción
Tipo de mensaje Tipo de mensaje de EDI
Validación de EDI Realiza una validación de EDI en los tipos de datos según lo definido en las propiedades de EDI del esquema, las restricciones de longitud, los elementos de datos vacíos y los separadores finales.
Validación extendida Si el tipo de datos no es EDI, lo que se valida es el requisito de elemento de datos, así como las repeticiones permitidas, las enumeraciones y la validación de la longitud del elemento de datos (mín. o máx.).
Permitir ceros iniciales/finales Conserve los caracteres de espacio y cero iniciales o finales adicionales. No los quite.
Recortar ceros iniciales y finales Quite cualquier carácter de espacio y cero inicial o final.
Directiva de separador final Genere separadores finales.

- No permitido: Prohíbe los delimitadores y separadores finales en el intercambio de entrada. Si el intercambio contiene delimitadores y separadores finales, se declara no válido.

- Opcional: acepta intercambios con o sin delimitadores y separadores finales.

- Obligatorio: El intercambio de entrada debe contener delimitadores y separadores finales.

Internal Settings (Configuración interna)

Propiedad Descripción
Convertir formato decimal implícito Nn en valor numérico de base 10 Convierte un número EDI especificado con el formato "Nn" en un valor numérico de base 10.
Crear etiquetas XML vacías si se permiten los separadores finales Hace que el remitente del intercambio incluya etiquetas XML vacías para los separadores finales.
Dividir intercambio como conjuntos de transacciones: suspender conjuntos de transacciones en caso de error Analiza todos los conjuntos de transacciones de un intercambio en un documento XML independiente aplicando el sobre adecuado al conjunto de transacciones. Solo suspende aquellas transacciones en las que se produce un error en la validación.
Dividir intercambio como conjuntos de transacciones: suspender intercambio en caso de error Analiza todos los conjuntos de transacciones que hay en un intercambio en un documento XML independiente aplicando el sobre adecuado. Suspende todo el intercambio cuando uno o varios conjuntos de transacciones no superan la validación.
Conservar intercambio: suspender conjuntos de transacciones en caso de error Deja intacto el intercambio y crea un documento XML para todo el intercambio por lotes. Suspende solo los conjuntos de transacciones que no superan la validación, pero sigue procesando el resto.
Conservar intercambio: suspender intercambio en caso de error Deja intacto el intercambio y crea un documento XML para todo el intercambio por lotes. Suspende todo el intercambio cuando uno o varios conjuntos de transacciones del intercambio no superan la validación.

Configuración de envío de X12

Captura de pantalla que muestra Azure Portal y la configuración del contrato X12 para los mensajes salientes.

Identificadores

Propiedad Descripción
ISA1 (calificador de autorización) Valor del calificador de autorización que quiere usar. El valor predeterminado es 00 - No existe información de autorización.

Nota: Si selecciona otros valores, especifique un valor para la propiedad ISA2.
ISA2 Valor de la información de autorización que se usará cuando la propiedad ISA1 no esté definida como 00 - No existe información de autorización. Este valor de propiedad debe tener un carácter alfanumérico como mínimo y 10 como máximo.
ISA3 (calificador de seguridad) Valor del calificador de seguridad que quiere usar. El valor predeterminado es 00 - No existe información de seguridad.

Nota: Si selecciona otros valores, especifique un valor para la propiedad ISA4.
ISA4 Valor de la información de seguridad que se usará cuando la propiedad ISA3 no esté definida como 00 - No existe información de seguridad. Este valor de propiedad debe tener un carácter alfanumérico como mínimo y 10 como máximo.

Acknowledgement (Confirmación)

Propiedad Descripción
TA1 esperada Devuelva una confirmación técnica (TA1) al remitente del intercambio.

Esta configuración especifica que el asociado del host que envía el mensaje solicita una confirmación del asociado invitado en el contrato. El asociado del host espera estas confirmaciones en función de la configuración de recepción del contrato.
FA esperada Devuelva una confirmación funcional (FA) al remitente del intercambio. Para la propiedad Versión de FA, en función de la versión de esquema, seleccione la confirmación 997 o 999.

Esta configuración especifica que el asociado del host que envía el mensaje solicita una confirmación del asociado invitado en el contrato. El asociado del host espera estas confirmaciones en función de la configuración de recepción del contrato.

Esquemas

En esta sección, seleccione un esquema de la cuenta de integración para cada tipo de transacción (ST01). Después de completar cada fila, aparece una fila vacía automáticamente.

Propiedad Descripción
Versión Versión X12 para el esquema.
Tipo de transacción (ST01) Tipo de transacción para el esquema
Esquema Archivo de esquema que quiere usar. Si selecciona primero el esquema, la versión y el tipo de transacción se definen automáticamente.

Sobres

Propiedad Descripción
Uso de ISA11 Separador que se va a usar en un conjunto de transacciones:

- Identificador estándar: Use un punto (.) para la notación decimal, en lugar de la notación decimal del documento de salida de la canalización de envío de EDI.

- Separador de repeticiones: Especifique el separador para las repeticiones de un elemento de datos simple o una estructura de datos repetida. Por ejemplo, normalmente se utiliza el acento circunflejo (^) como separador de repeticiones. En los esquemas HIPAA, solo se puede usar el acento circunflejo.

Número de versión de control

En esta sección, seleccione un esquema de la cuenta de integración para cada intercambio. Después de completar cada fila, aparece una fila vacía automáticamente.

Propiedad Descripción
Número de versión de control (ISA12) Versión del estándar X12
Indicador de uso (ISA15) Contexto de un intercambio, que pueden ser datos de Prueba, de Information o de Producción
Esquema Esquema que se usará para generar los segmentos GS y ST para un intercambio X12 codificado que se envía a la canalización de envío de EDI.
GS1 Opcional: seleccione el código funcional.
GS2 Opcional: especifique el emisor de la aplicación.
GS3 Opcional: especifique el receptor de la aplicación.
GS4 Opcional: seleccione CCYYMMDD o YYMMDD.
GS5 Opcional: seleccione HHMM, HHMMSS o HHMMSSdd.
GS7 Opcional, seleccione un valor para la agencia responsable.
GS8 Opcional, especifique la versión del documento de esquema.

Control Numbers (Números de control)

Propiedad Descripción
Número de control de intercambio (ISA13) Intervalo de valores para el número de control de intercambio, que puede tener un valor mínimo de 1 y un máximo de 999999999
Número de control de grupo (GS06) Intervalo de valores para el número de control de grupo, que puede tener un valor mínimo de 1 y un máximo de 999999999
Número de control de conjunto de transacciones (ST02) Intervalo de valores para el número de control del conjunto de transacciones, que puede tener un valor mínimo de 1 y un valor máximo de 999999999

- Prefijo: opcional, un valor alfanumérico
- Sufijo: opcional (valor alfanumérico)

Juegos de caracteres y separadores

La fila Predeterminado muestra el juego de caracteres que se usa como delimitador para un esquema de mensaje. Si no quiere usar el juego de caracteres Predeterminado, puede especificar un conjunto de delimitadores diferente para cada tipo de mensaje. Después de completar cada fila, aparece una fila vacía automáticamente.

Sugerencia

Para proporcionar valores de caracteres especiales, edite el contrato como JSON y proporcione el valor ASCII para el carácter especial.

Propiedad Descripción
Juego de caracteres que se va a usar El juego de caracteres X12, que es Básico, Extendido o UTF8.
Esquema Esquema que quiere usar. Después de seleccionar el esquema, elija el juego de caracteres que quiera usar, en función de las siguientes descripciones.
Tipo de entrada Tipo de entrada para el juego de caracteres
Separador de componentes Carácter único que separa los elementos de datos compuestos
Separador de elementos de datos Carácter único que separa los elementos de datos sencillos dentro de los datos compuestos
Separador de caracteres de reemplazo Un carácter de reemplazo que reemplaza todos los caracteres separadores en los datos de carga al generar el mensaje X12 de salida.
Terminador de segmento Carácter único que indica el final de un segmento EDI
Sufijo Carácter que se usa con el identificador del segmento. Si especifica un sufijo, el elemento de datos del terminador de segmento puede estar vacío. Si el terminador de segmentos se deja vacío, debe designar un sufijo.

Validation

La fila predeterminada muestra las reglas de validación que se usan para un tipo de mensaje de EDI. Si quiere definir otras reglas, seleccione cada uno de los cuadros en los que quiera definir el conjunto de reglas como true. Después de completar cada fila, aparece una fila vacía automáticamente.

Propiedad Descripción
Tipo de mensaje Tipo de mensaje de EDI
Validación de EDI Realiza una validación de EDI en los tipos de datos según lo definido en las propiedades de EDI del esquema, las restricciones de longitud, los elementos de datos vacíos y los separadores finales.
Validación extendida Si el tipo de datos no es EDI, lo que se valida es el requisito de elemento de datos, así como las repeticiones permitidas, las enumeraciones y la validación de la longitud del elemento de datos (mín. o máx.).
Permitir ceros iniciales/finales Conserve los caracteres de espacio y cero iniciales o finales adicionales. No los quite.
Recortar ceros iniciales y finales Quite cualquier carácter de espacio y cero inicial o final.
Directiva de separador final Genere separadores finales.

- No permitido: Prohíbe los delimitadores y separadores finales en el intercambio de salida. Si el intercambio contiene delimitadores y separadores finales, se declara no válido.

- Opcional: envía intercambios con o sin delimitadores y separadores finales.

- Obligatorio: el intercambio de salida debe contener delimitadores y separadores finales.

Esquemas HIPAA y tipos de mensaje

Cuando trabaje con esquemas HIPAA y los tipos de mensaje 277 u 837, deberá seguir algunos pasos adicionales. Los números de versión del documento (GS8) para estos tipos de mensajes tienen más de nueve caracteres; por ejemplo, "005010X222A1". Además, algunos números de versión de documento se asignan a tipos de mensaje variante. Si no hace referencia al tipo de mensaje correcto en el esquema y en el acuerdo, recibirá este mensaje de error:

"The message has an unknown document type and did not resolve to any of the existing schemas configured in the agreement."

En esta tabla se enumeran los tipos de mensaje afectados, cualquier variante y los números de versión de documento que se asignan a esos tipos de mensaje:

Tipo de mensaje o variante Descripción Número de versión del documento (GS8)
277 Notificación de estado de información de asistencia sanitaria 005010X212
837_I Reclamación de asistencia sanitaria institucional 004010X096A1
005010X223A1
005010X223A2
837_D Reclamación de asistencia sanitaria dental 004010X097A1
005010X224A1
005010X224A2
837_P Reclamación de asistencia sanitaria profesional 004010X098A1
005010X222
005010X222A1

También debe deshabilitar la validación de EDI al usar estos números de versión de documento porque se produce un error que indica que la longitud de caracteres no es válida.

Para especificar estos números de versión del documento y tipos de mensaje, siga estos pasos:

Nota:

Cada mensaje con 837_P, 837_I o 837_D tipo requiere un contrato independiente.

  1. En el esquema HIPAA, reemplace el tipo de mensaje actual por el tipo de mensaje variante para el número de versión del documento que quiere usar.

    Por ejemplo, supongamos que quiere usar el número de versión del documento 005010X222A1 con el tipo de mensaje 837. En el esquema, reemplace cada valor "X12_00501_837" por el valor "X12_00501_837_P" en su lugar.

    Para actualizar el esquema, siga estos pasos:

    1. En Azure Portal, vaya a la cuenta de integración. Busque y descargue su esquema. Reemplace el tipo de mensaje y cambie el nombre del archivo de esquema, y cargue el esquema revisado en la cuenta de integración. Para obtener más información, vea Edición de un esquema.

    2. En la configuración de mensajes del acuerdo, seleccione el esquema revisado.

  2. En el objeto schemaReferences del contrato, agregue otra entrada que especifique el tipo de mensaje variante que coincida con el número de versión del documento.

    Por ejemplo, supongamos que quiere usar el número de versión del documento 005010X222A1 para el tipo de mensaje 837. El contrato tiene una sección schemaReferences con estas propiedades y valores:

    "schemaReferences": [
       {
          "messageId": "837",
          "schemaVersion": "00501",
          "schemaName": "X12_00501_837"
       }
    ]
    

    Edite la schemaReferences sección para que tenga un aspecto similar al del ejemplo siguiente:

    "schemaReferences": [
       {
          "messageId": "837",
          "schemaVersion": "00501",
          "schemaName": "X12_00501_837_P"
       }
    ]
    
  3. En la configuración de mensajes del contrato, deshabilite la validación de EDI desactivando la casilla Validación EDI para cada tipo de mensaje o para todos si usa los valores predeterminados .

    Captura de pantalla que muestra la configuración del contrato X12 para deshabilitar la validación de todos los tipos de mensajes o de cada tipo de mensaje.

Pasos siguientes

Intercambio de mensajes X12