Intercambio de mensajes X12 mediante flujos de trabajo en Azure Logic Apps

  • Artículo

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

Para enviar y recibir mensajes X12 en los flujos de trabajo que crea mediante Azure Logic Apps, use el conector X12, que ofrece operaciones que admiten y administran comunicaciones X12.

En esta guía paso a paso se muestra cómo agregar las acciones de codificación y descodificación X12 a un flujo de trabajo de aplicación lógica existente. El conector X12 no incluye ningún desencadenador, por lo que puede usar cualquier desencadenador para iniciar el flujo de trabajo. Los ejemplos de esta guía usan el Desencadenador de solicitud.

Referencia técnica del conector

El conector X12 tiene una versión para todos flujos de trabajo en Azure Logic Apps de multiinquilino, Azure Logic Apps de inquilino único y el entorno del servicio de integración (ISE). Para obtener información técnica sobre el conector X12, consulte la siguiente documentación:

Requisitos previos

  • Una cuenta y una suscripción de Azure. Si aún no tiene ninguna suscripción de Azure, regístrese para obtener una cuenta gratuita de Azure.

  • Un recurso de cuenta de integración, donde se definen y almacenan artefactos, como socios comerciales, contratos, certificados, entre otros, para su uso en los flujos de trabajo de integración empresarial y B2B. Este recurso tiene que satisfacer los siguientes requisitos:

    • Tanto la cuenta de integración como el recurso de aplicación lógica deben existir en la misma suscripción y región de Azure.

    • Define al menos dos asociados comerciales que participen en la operación X12 utilizada en el flujo de trabajo. Las definiciones de ambos asociados deben usar el mismo calificador X12 de identidad empresarial.

    • Define un contrato X12 entre los asociados comerciales que participan en el flujo de trabajo. En cada contrato hacen falta un asociado anfitrión y un asociado invitado. El contenido de los mensajes entre usted y el otro asociado debe coincidir con el tipo de contrato. Para obtener información sobre la configuración del contrato que se va a usar al recibir y enviar mensajes, consulte configuración de mensaje X12.

      Importante

      Si está trabajando con esquemas de la Ley de Transferencia y Responsabilidad de Seguros de Salud (HIPAA), debe agregar una sección schemaReferences al acuerdo. Para más información, consulte Tipos de esquemas y mensaje de HIPAA.

    • Define los esquemas que se utilizarán para la validación XML.

      Importante

      Si está trabajando con esquemas de la Ley de Transferencia y Responsabilidad de Seguros de Salud (HIPAA), no olvide consulta Esquemas HIPAA y tipos de mensaje.

  • En función de si está trabajando en un flujo de trabajo de aplicación lógica de consumo o en uno estándar, es posible que el recurso de la aplicación lógica necesite un vínculo a la cuenta de integración:

    Flujo de trabajo de la aplicación lógica ¿Se necesita un vínculo?
    Consumo se requieren Conectar ion y vínculo a la cuenta de integración. Puede crear la conexión al agregar la operación X12 al flujo de trabajo.
    Estándar Se necesita la conexión a la cuenta de integración, pero no se necesita ningún vínculo. Puede crear la conexión al agregar la operación X12 al flujo de trabajo.

  • El recurso de aplicación lógica y el flujo de trabajo donde quiere usar las operaciones X12.

    Para más información, consulte la siguiente documentación:

Codificación de mensajes X12

La operación de Codificar en mensaje X12 realiza las siguientes tareas:

  • Resuelve el contrato haciendo coincidir las propiedades de contexto de remitente y de receptor.
  • Serializa el intercambio EDI y convierte los mensajes codificados en XML en conjuntos de transacciones EDI en el intercambio.
  • Aplica segmentos de encabezado y finalizador del conjunto de transacciones.
  • Genera un número de control de intercambio, un número de control de grupo y un número de control del conjunto de transacciones para cada intercambio de salida.
  • Reemplaza los separadores en los datos de carga útil.
  • Valida propiedades EDI y específicas del asociado.
    • Validación del esquema de elementos de datos del conjunto de transacciones en relación con el esquema de mensaje.
    • Validación de EDI en los elementos de datos del conjunto de transacciones.
    • Validación extendida en los elementos de datos del conjunto de transacciones.
  • Solicita una confirmación técnica y funcional, si esta opción está configurada.
    • Se genera una confirmación técnica como resultado de la validación de encabezado. La confirmación técnica informa del estado del procesamiento de un encabezado y finalizador de intercambio por parte del receptor de la dirección.
    • Se genera una confirmación funcional como resultado de la validación del cuerpo. La confirmación funcional notifica cada error detectado al procesar el documento recibido.

  1. En Azure Portal, abra el recurso de la aplicación lógica y el flujo de trabajo en el diseñador.

  2. En el diseñador, siga estos pasos generales para agregar la acción X12 denominada Codificar en mensaje X12 por nombre del contrato al flujo de trabajo.

    Nota:

    Si quiere usar la acción Codificar en mensaje X12 por identidades en su lugar, más adelante tendrá que proporcionar valores diferentes, como el identificador de remitente y el identificador de receptor especificados por el contrato X12. También debe especificar el mensaje XML para codificar, que puede ser la salida del desencadenador o una acción anterior.

  3. Cuando se le solicita, proporcione la información de conexión siguiente para la cuenta de integración:

    Propiedad Obligatorio Descripción
    Nombre de la conexión Sí Un nombre para la conexión
    Cuenta de integración Sí En la lista de cuentas de integración disponibles, seleccione la cuenta que desea usar.

    Por ejemplo:

    Screenshot showing Consumption workflow and connection information for action named Encode to X12 message by agreement name.

  4. Seleccione Crear cuando haya terminado.

  5. En el cuadro de información de la acción X12, proporcione los siguientes valores de propiedad:

    Propiedad Obligatorio Descripción
    Name of X12 agreement Sí El contrato X12 que se va a usar.
    Mensaje XML que se va a codificar Sí El mensaje XML que se va a codificar
    Otros parámetros No Esta operación incluye los siguientes parámetros:

    - Separador de elementos de datos
    - Separador de componentes
    - Carácter de reemplazo
    - Terminador de segmentos
    - Sufijo de terminador de segmento
    - Número de versión de control
    - Código GS02/Identificador de remitente de la aplicación
    - Código GS03/Identificador de receptor de la aplicación

    Para obtener más información, revise configuración de mensajes X12.

    Por ejemplo, puede usar la salida de contenido de Cuerpo del desencadenador de Solicitud como carga del mensaje XML:

    Screenshot showing Consumption workflow, action named Encode to X12 message by agreement name, and action properties.

Descodificación de mensajes X12

La operación de Descodificar mensaje X12 realiza las siguientes tareas:

  • Valida el sobre con el acuerdo entre socios comerciales.

  • Valida propiedades EDI y específicas del asociado.

    • Validación estructural de EDI y validación del esquema extendido
    • Validación estructural del sobre de intercambio
    • Validación del esquema del sobre con respecto al esquema de control
    • Validación del esquema de los elementos de datos del conjunto de transacciones en relación con el esquema de mensaje
    • Validación de EDI en los elementos de datos del conjunto de transacciones

  • Comprueba que los números de control de intercambio, grupo y conjunto de transacciones no están duplicados.

    • Comprueba el número de control del intercambio en relación con los intercambios recibidos anteriormente.
    • Comprueba el número de control del grupo en relación con otros números de control de grupo en el intercambio.
    • Comprueba el número de control del conjunto de transacciones con otros números de control del conjunto de transacciones de dicho grupo.

  • Divide un intercambio en conjuntos de transacciones o conserva todo el intercambio:

    • Dividir el intercambio en conjuntos de transacciones o suspender conjuntos de transacciones en caso de error: Analizar cada conjunto de transacciones. La acción de descodificación X12 genera solo los conjuntos de transacciones que no se validan en badMessagesy genera los conjuntos de transacciones restantes en goodMessages.

    • Dividir el intercambio en conjuntos de transacciones o suspender el intercambio en caso de error: Analizar cada conjunto de transacciones. Si uno o varios conjuntos de transacciones del intercambio no superan la validación, la acción de descodificación X12 establece todos los conjuntos de transacciones del intercambio en badMessages.

    • Conservar el intercambio o suspender conjuntos de transacciones en caso de error: Conservar el intercambio y procesa todo el intercambio por lotes. La acción de descodificación X12 genera solo los conjuntos de transacciones que no se validan en badMessagesy genera los conjuntos de transacciones restantes en goodMessages.

    • Conservar el intercambio o suspender el intercambio en caso de error: Conservar el intercambio y procesa todo el intercambio por lotes. Si uno o varios conjuntos de transacciones del intercambio no superan la validación, la acción de descodificación X12 establece todos los conjuntos de transacciones del intercambio en badMessages.

  • Genera una confirmación técnica y funcional, si esta opción está configurada.

    • Se genera una confirmación técnica como resultado de la validación de encabezado. La confirmación técnica informa del estado del procesamiento de un encabezado y finalizador de intercambio por parte del receptor de la dirección.
    • Se genera una confirmación funcional como resultado de la validación del cuerpo. La confirmación funcional notifica cada error detectado al procesar el documento recibido.

  1. En Azure Portal, abra el recurso de la aplicación lógica y el flujo de trabajo en el diseñador.

  2. En el diseñador, siga estos pasos generales para agregar la acción X12 denominada Descodificar mensaje X12 al flujo de trabajo.

  3. Cuando se le solicita, proporcione la información de conexión siguiente para la cuenta de integración:

    Propiedad Obligatorio Descripción
    Nombre de la conexión Sí Un nombre para la conexión
    Cuenta de integración Sí En la lista de cuentas de integración disponibles, seleccione la cuenta que desea usar.

    Por ejemplo:

    Screenshot showing Consumption workflow and connection information for action named Decode X12 message.

  4. Seleccione Crear cuando haya terminado.

  5. En el cuadro de información de la acción X12, proporcione los siguientes valores de propiedad:

    Propiedad Obligatorio Descripción
    Mensaje de archivo plano X12 que se va a descodificar Sí Mensaje X12 en formato de archivo plano que se va a descodificar

    Nota: La carga o el contenido del mensaje XML para el matriz del mensaje, bien o mal, están codificado en base64. Por lo tanto, debe usar una expresión que procese este contenido. Por ejemplo, la expresión siguiente procesa el contenido del mensaje como XML:

    xml(base64ToBinary(item()?['Body']))
    Otros parámetros No Esta operación incluye los siguientes parámetros:

    - Conservar intercambio
    - Suspender el intercambio en caso de error

    Para obtener más información, revise configuración de mensajes X12.

    Por ejemplo, puede usar la salida de contenido de Cuerpo del desencadenador de solicitud como carga del mensaje XML, pero primero debe pre-procesar este contenido mediante una expresión:

    Screenshot showing Consumption workflow, action named Decode X12 message, and action properties.

Pasos siguientes