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

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

Para enviar y recibir mensajes X12 en flujos de trabajo que cree mediante Azure Logic Apps, use el conector X12 . Este conector proporciona operaciones que admiten y administran la comunicación X12.

En esta guía se muestra cómo agregar las acciones de codificación y descodificación para X12 a un flujo de trabajo de aplicación lógica existente. Puede usar cualquier desencadenador con las acciones X12. En los ejemplos de esta guía se usa el desencadenador de solicitud.

Referencia técnica del conector

El conector X12 tiene versiones diferentes, basadas en el tipo de aplicación lógica y el entorno de host.

Operaciones integradas X12

En las secciones siguientes se describen las operaciones del conector integrados X12 y sus parámetros:

Descodificar X12

Identificador de operación: x12Decode

Descodifica un mensaje X12 convirtiendo el archivo plano en formato XML.

Parámetros

Codificar X12

Identificador de operación: x12Encode

Codifica un mensaje X12 convirtiendo XML en formato de archivo plano.

Parámetros

Codificación del lote X12

Identificador de operación: x12BatchEncode

Codifica un lote de mensajes X12 convirtiendo XML en formato de archivo plano.

Parámetros

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.

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

  Para obtener más información, consulte:

  • Creación de un flujo de trabajo de aplicación lógica de consumo en Azure Logic Apps
  • Creación de un flujo de trabajo de aplicación lógica estándar en Azure Logic Apps

• Un recurso de la cuenta de integración para definir y almacenar artefactos para utilizarlos en flujos de trabajo de integración empresarial y B2B.

  • Tanto la cuenta de integración como el recurso de aplicación lógica deben existir en la misma suscripción de Azure y en la misma 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 Portabilidad y Responsabilidad del Seguro Médico (HIPAA), debe agregar una sección schemaReferences a su contrato. 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.

• Antes de empezar a trabajar con operaciones X12, debe vincular la aplicación lógica de consumo o vincular la aplicación lógica Estándar a una cuenta de integración.

  Al agregar una operación X12, también debe crear una conexión a la cuenta de integración. Puede crear la conexión al agregar la operación X12 al flujo de trabajo.

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 electrónico de datos (EDI) y convierte los mensajes codificados con 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.

Para codificar mensajes con el conector X12, siga estos pasos:

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 de parámetros diferentes, como el identificador de remitente y el identificador de receptor especificados por el contrato X12. También debe especificar el valor del mensaje XML para codificar, que puede seleccionar como salida del desencadenador o de una acción previa.

3. Cuando se le pida que cree una conexión a su cuenta de integración, proporcione la siguiente información:

   Parámetro	Obligatorio	Descripción
   Nombre de la conexión	Sí	Nombre de la conexión.
   Id. de cuenta de integración	Sí	El identificador de recurso de la cuenta de integración, que tiene el formato siguiente: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name> Por ejemplo: /subscriptions/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount Para encontrar este identificador de recurso, siga estos pasos: 1. En el Azure Portal, abra la cuenta de integración. 2. En la barra lateral de la cuenta de integración, seleccione Información general. 3. En la página Información general, seleccione el Vista JSON. 4. Desde la propiedad Identificador de recurso, copie el valor.
   Dirección URL de SAS de la cuenta de integración	Sí	La dirección URL del punto de conexión de solicitud que usa la autenticación de firma de acceso compartido (SAS) para proporcionar acceso a la cuenta de integración. Esta dirección URL de devolución de llamada tiene el formato siguiente: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature> Por ejemplo: https://prod-04.west-us.logic-azure.com:443/integrationAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=aB1cD2eF-3gH4iJ5kL6-mN7oP8qR Para encontrar esta dirección URL, siga estos pasos: 1. En el Azure Portal, abra la cuenta de integración. 2. En la barra lateral de la cuenta de integración, en Configuración, seleccione Dirección URL de devolución de llamada. 3. Desde la propiedad Dirección URL de devolución de llamada generada, copie el valor.
   Tamaño del bloque de números de control	No	Tamaño de bloque de números de control que se van a reservar de un contrato para escenarios de alto rendimiento

   Por ejemplo:

   

4. Cuando haya terminado, seleccione Crear nuevo.

5. En el panel de información de acciones X12, proporcione los siguientes valores:

   Parámetro	Obligatorio	Descripción
   Nombre del contrato X12	Sí	El contrato X12 que se va a usar.
   Mensaje XML que se va a codificar	Sí	Mensaje XML que se va a codificar.
   Parámetros avanzados	No	Más parámetros que puede seleccionar: - 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 (ISA12) - 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, consulte Configuración de mensajes X12.

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

   Para buscar y seleccionar esta salida, siga estos pasos:

   1. Seleccione en el cuadro de mensaje XML para codificar y luego seleccione el icono de rayo para abrir la lista de contenido dinámico.

   2. En la lista, en Cuando se recibe un mensaje HTTP, seleccione Cuerpo.

   

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 con respecto al 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 procesar 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 suspenderlo en caso de error: Conservar el intercambio y procesar 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.

Para descodificar mensajes X12 en el flujo de trabajo con el conector X12, siga estos pasos:

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 pida que cree una conexión a su cuenta de integración, proporcione la siguiente información:

   Parámetro	Obligatorio	Descripción
   Nombre de la conexión	Sí	Nombre de la conexión.
   Id. de cuenta de integración	Sí	El identificador de recurso de la cuenta de integración, que tiene el formato siguiente: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name> Por ejemplo: /subscriptions/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount Para encontrar este identificador de recurso, siga estos pasos: 1. En el Azure Portal, abra la cuenta de integración. 2. En la barra lateral de la cuenta de integración, seleccione Información general. 3. En la página Información general, seleccione el Vista JSON. 4. Desde la propiedad Identificador de recurso, copie el valor.
   Dirección URL de SAS de la cuenta de integración	Sí	La dirección URL del punto de conexión de solicitud que usa la autenticación de firma de acceso compartido (SAS) para proporcionar acceso a la cuenta de integración. Esta dirección URL de devolución de llamada tiene el formato siguiente: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature> Por ejemplo: https://prod-04.west-us.logic-azure.com:443/integrationAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=aB1cD2eF-3gH4iJ5kL6-mN7oP8qR Para encontrar esta dirección URL, siga estos pasos: 1. En el Azure Portal, abra la cuenta de integración. 2. En la barra lateral de la cuenta de integración, en Configuración, seleccione Dirección URL de devolución de llamada. 3. Desde la propiedad Dirección URL de devolución de llamada generada, copie el valor.
   Tamaño del bloque de números de control	No	Tamaño de bloque de números de control que se van a reservar de un contrato para escenarios de alto rendimiento

   Por ejemplo:

   

4. Cuando haya terminado, seleccione Crear nuevo.

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

   Parámetro	Obligatorio	Descripción
   Mensaje de archivo plano X12 que se va a descodificar	Sí	El mensaje X12 en formato de archivo plano que se va a descodificar Nota: La carga de mensajes XML o el contenido de una matriz de mensajes está codificada en base64. Debe usar una expresión que procese este contenido. Por ejemplo, la expresión siguiente procesa el contenido de una matriz de mensajes como XML mediante las xml()funciones , base64ToBinary()y item() : xml(base64ToBinary(item()?['Body']))
   Parámetros avanzados	No	Esta operación incluye los siguientes parámetros: - Conservar intercambio - Suspender intercambio en caso de error Para obtener más información, consulte Configuración de mensajes X12.

   Por ejemplo, puede usar la salida de contenido body del desencadenador Request como carga del mensaje XML, pero primero debe procesar este contenido como se muestra en la expresión siguiente:

   xml(base64ToBinary(item()?['Body']))

   Para completar esta tarea, siga estos pasos:

   1. Seleccione dentro del cuadro mensaje de archivo plano X12 para descodificar y, a continuación, seleccione el icono de función para abrir el editor de expresiones.

   2. En el cuadro editor de expresiones, escriba la expresión siguiente, que hace referencia a la salida Cuerpo del desencadenador Solicitud:

      xml(base64ToBinary(string(triggerBody())))

   3. Cuando finalice, seleccione Agregar.

   

Contenido relacionado

• 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