Mensagens X12 do Exchange utilizando fluxos de trabalho nos Aplicativos Lógicos do Azure

  • Artigo

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Para enviar e receber mensagens X12 nos fluxos de trabalho que você cria usando os Aplicativos Lógicos do Azure, utilize o conector X12, que fornece operações que suportam e gerenciam a comunicação X12.

Este guia prático mostra como adicionar as ações de codificação e decodificação X12 a um fluxo de trabalho de aplicativo lógico existente. O conector X12 não inclui nenhum gatilho, portanto, você pode utilizar qualquer gatilho para iniciar seu fluxo de trabalho. Os exemplos deste guiará utilizam o gatilho de Solicitação.

Referência técnica do conector

O conector X12 tem uma versão para fluxos de trabalho nos Aplicativos Lógicos do Azure de vários locatários, Aplicativos Lógicos do Azure de locatário único e no Ambiente do Serviço de Integração (ISE). Para obter informações técnicas sobre o conector X12, confira a documentação a seguir:

Pré-requisitos

  • Uma conta e uma assinatura do Azure. Caso você ainda não tenha uma assinatura do Azure, inscreva-se em uma conta gratuita do Azure.

  • Um recurso de conta de integração no qual você define e armazena artefatos, como parceiros comerciais, contratos, certificados e assim por diante, para usar em seus fluxos de trabalho de integração empresarial e B2B. O recurso precisa atender aos seguintes requisitos:

    • Tanto sua conta de integração quanto o recurso do aplicativo lógico devem existir na mesma assinatura e região do Azure.

    • Define pelo menos dois parceiros de negócios que participam da operação X12 utilizada em seu fluxo de trabalho. As definições de ambos os parceiros devem utilizar o mesmo qualificador de identidade comercial X12.

    • Define um contrato X12 entre os parceiros comerciais que participam do seu fluxo de trabalho. Cada contrato requer um parceiro de host e um parceiro convidado. O conteúdo das mensagens entre você e o outro parceiro deve corresponder ao tipo de contrato. Para obter informações sobre as configurações do contrato a serem utilizadas ao receber e enviar mensagens, confira Configurações da mensagem X12.

      Importante

      Se você estiver trabalhando com esquemas HIPAA (Health Insurance Portability and Accountability Act), precisará adicionar uma seção schemaReferences no seu contrato. Para obter mais informações, confira Esquemas e tipos de mensagem HIPAA.

    • Define os esquemas a serem utilizados na validação do XML.

      Importante

      Se você estiver trabalhando com esquemas HIPAA (Health Insurance Portability and Accountability Act), examine Esquemas HIPAA e tipos de mensagem.

  • Dependendo de se você está trabalhando em um fluxo de trabalho de aplicativo lógico de Consumo ou Standard, seu recurso de aplicativo lógico poderá exigir um link para sua conta de integração:

    Fluxo de trabalho do Aplicativo Lógico Link necessário?
    Consumo A conexão e o link para a conta de integração são necessários. Você pode criar a conexão ao adicionar a operação X12 ao seu fluxo de trabalho.
    Standard É exigida a conexão com a conta de integração, mas não é necessário um link. Você pode criar a conexão ao adicionar a operação X12 ao seu fluxo de trabalho.

  • O recurso do aplicativo lógico e o fluxo de trabalho para o qual você deseja utilizar as operações X12.

    Para saber mais, confira a seguinte documentação:

Codificar mensagens do X12

A operação Codificar para mensagens X12 executa as seguintes tarefas:

  • Resolve o contrato fazendo a correspondência entre as propriedades de contexto do remetente e do destinatário.
  • Serializa o intercâmbio EDI e converte mensagens codificadas em XML em conjuntos de transações EDI no intercâmbio.
  • Aplica os segmentos de cabeçalho e trailer do conjunto de transações.
  • Gera um número de controle de intercâmbio, um número de controle de grupo e um número de controle de conjunto de transações para cada intercâmbio de saída.
  • Substitui os separadores nos dados do payload.
  • Valida o EDI e as propriedades específicas do parceiro.
    • Validação do esquema dos elementos de dados do conjunto de transações em relação ao esquema de mensagens.
    • Validação do EDI nos elementos de dados do conjunto de transações.
    • Validação estendida em elementos de dados do conjunto de transações.
  • Solicita um Reconhecimento Técnico e Funcional, se configurado.
    • Gera uma Confirmação Técnica como resultado da validação do cabeçalho. A confirmação técnica relata o status do processamento de um cabeçalho e rodapé de intercâmbio pelo destinatário no endereço.
    • Gera um Reconhecimento Funcional como resultado da validação do corpo. A confirmação funcional relata cada erro encontrado durante o processamento do documento recebido.

  1. No portal do Azure, abra o recurso de aplicativo lógico e o fluxo de trabalho no designer.

  2. No designer, siga estas etapas gerais para adicionar a ação X12 denominada Codificar para mensagens X12 pelo nome do contrato para seu fluxo de trabalho.

    Observação

    Se, em vez disso, quiser utilizar a ação Codificar para mensagem X12 por identidades, será necessário fornecer valores diferentes, como o Identificador do remetente e o Identificador do destinatário especificados pelo seu contrato X12. Você também precisa especificar a mensagem XML para codificar, que pode ser a saída do gatilho ou uma ação anterior.

  3. Quando solicitado, forneça as seguintes informações de conexão para sua conta de integração:

    Propriedade Obrigatório Descrição
    Nome da conexão Yes Um nome para a conexão
    Conta de integração Yes Na lista de contas de integração disponíveis, selecione a conta a ser usada.

    Por exemplo:

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

  4. Quando terminar, selecione Criar.

  5. Na caixa de informações da ação X12, forneça os seguintes valores da propriedade:

    Propriedade Obrigatório Descrição
    Nome do contrato do X12 Sim O contrato X12 que será utilizado.
    Mensagem XML para codificar Sim A mensagem XML que será codificada
    Outros parâmetros Não Esta operação inclui os seguintes outros parâmetros:

    - Separador de elemento de dados
    - Separador de componente
    - Caractere de substituição
    - Terminador de segmento
    - Sufixo do terminador de segmento
    - Número da Versão de Controle
    - Identificador/Código do Remetente do Aplicativo GS02
    - Identificador/Código do Receptor do Aplicativo GS03

    Para obter mais informações, consulte Configurações de mensagens X12.

    Por exemplo, você pode utilizar a saída de conteúdo Corpo do gatilho da Solicitação como payload da mensagem XML:

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

Decodificar mensagens X12

A operação Decodificar a mensagem X12 desempenha as seguintes tarefas:

  • Valida o envelope com relação ao acordo entre parceiros comerciais.

  • Valida o EDI e as propriedades específicas do parceiro.

    • Validação estrutural do EDI e validação do esquema estendido
    • Validação estrutural do envelope de intercâmbio
    • Validação de esquema do envelope em relação ao esquema de controle
    • Validação do esquema dos elementos de dados do conjunto de transações em relação ao esquema de mensagens
    • Validação do EDI nos elementos de dados do conjunto de transações

  • Verifica se os números de controle do intercâmbio, do grupo e do conjunto de transações não são duplicados.

    • Verifica o número de controle de intercâmbio em relação aos intercâmbios recebidos anteriormente.
    • Verifica o número de controle de grupo em relação a outros números de controle no intercâmbio.
    • Verifica o número de controle do conjunto de transações em relação a outros números de controle de conjunto de transações nesse grupo.

  • Divide um intercâmbio em conjuntos de transações ou preserva o intercâmbio inteiro:

    • Dividir o intercâmbio em conjuntos de transações ou suspender os conjuntos de transações em caso de erro: analisar cada conjunto de transações. A ação de decodificação X12 gera apenas os conjuntos de transações que falham na validação para badMessages, e gera os conjuntos de transações restantes como goodMessages.

    • Dividir o intercâmbio em conjuntos de transações ou suspender o intercâmbio em caso de erro: analisar cada conjunto de transações. Se um ou mais conjuntos de transações no intercâmbio falharem na validação, a ação de decodificação X12 enviará todos os conjuntos de transações nesse intercâmbio para badMessages.

    • Preservar o intercâmbio ou suspender os conjuntos de transações por erro: preservar o intercâmbio e processar todo o intercâmbio em lote. A ação de decodificação X12 gera apenas os conjuntos de transações que falham na validação para badMessages, e gera os conjuntos de transações restantes como goodMessages.

    • Preservar o intercâmbio ou suspender o intercâmbio por erro: preservar o intercâmbio e processar todo o intercâmbio em lote. Se um ou mais conjuntos de transações no intercâmbio falharem na validação, a ação de decodificação X12 enviará todos os conjuntos de transações nesse intercâmbio para badMessages.

  • Gera um Reconhecimento técnico e funcional, se configurado.

    • Gera uma Confirmação Técnica como resultado da validação do cabeçalho. A confirmação técnica relata o status do processamento de um cabeçalho e rodapé de intercâmbio pelo destinatário no endereço.
    • Gera um Reconhecimento Funcional como resultado da validação do corpo. A confirmação funcional relata cada erro encontrado durante o processamento do documento recebido.

  1. No portal do Azure, abra o recurso de aplicativo lógico e o fluxo de trabalho no designer.

  2. No designer, siga estas etapas gerais para adicionar a ação X12 denominada Decodificar a mensagem X12 para seu fluxo de trabalho.

  3. Quando solicitado, forneça as seguintes informações de conexão para sua conta de integração:

    Propriedade Obrigatório Descrição
    Nome da conexão Yes Um nome para a conexão
    Conta de integração Yes Na lista de contas de integração disponíveis, selecione a conta a ser usada.

    Por exemplo:

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

  4. Quando terminar, selecione Criar.

  5. Na caixa de informações da ação X12, forneça os seguintes valores da propriedade:

    Propriedade Obrigatório Descrição
    Mensagem X12 de arquivo simples para decodificar Sim A mensagem X12 em formato de arquivo simples para decodificar

    Observação: o payload da mensagem XML ou o conteúdo da matriz de mensagens, boas ou ruins, é codificado em base64. Portanto, você deve utilizar uma expressão que processe esse conteúdo. Por exemplo, a expressão a seguir processa o conteúdo da mensagem como XML:

    xml(base64ToBinary(item()?['Body']))
    Outros parâmetros Não Esta operação inclui os seguintes outros parâmetros:

    - Preservar intercâmbio
    - Suspender o intercâmbio por erro

    Para obter mais informações, consulte Configurações de mensagens X12.

    Por exemplo, você pode utilizar a saída de conteúdo Corpo do gatilho da Solicitação como payload da mensagem XML, mas primeiro deve pré-processar esse conteúdo usando uma expressão:

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

Próximas etapas