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

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 en todos los flujos de trabajo en Azure Logic Apps multiinquilino y Azure Logic Apps de inquilino único. Para obtener información técnica sobre el conector X12, consulte la siguiente documentación:

• Página de referencia del conector, en la cual se describen los desencadenadores, acciones y límites que se documentan en el archivo de Swagger del conector

• Límites del protocolo B2B para tamaños de mensaje

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 requiere conexión 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:

  • Creación de un ejemplo de flujo de trabajo de aplicación lógica de Consumo en Azure Logic Apps multiinquilino

  • Creación de un ejemplo de flujo de trabajo de aplicación lógica del plan Estándar en Azure Logic Apps de un solo inquilino

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 informa de cada error encontrado al procesar el documento recibido.

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 solo genera los conjuntos de transacciones que no superan la validación para badMessages y los resultados de las transacciones restantes se establecen 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 solo genera los conjuntos de transacciones que no superan la validación para badMessages y los resultados de las transacciones restantes se establecen 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 informa de cada error encontrado al procesar el documento recibido.

Pasos siguientes

• Códigos de error y confirmaciones técnicas TA1 de X12
• Códigos de error y confirmaciones funcionales 997 de X12
• Configuración de mensajes X12