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

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

Para enviar e receber mensagens X12 em fluxos de trabalho criados usando os Aplicativos Lógicos do Azure, use o conector X12, que fornece operações que dão suporte e gerenciam a comunicação X12.

Este guia de instruções 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 usar qualquer gatilho para iniciar seu fluxo de trabalho. Os exemplos neste guia usam o gatilho Request.

Referência técnica do conector

O conector X12 tem uma versão entre fluxos de trabalho em Aplicativos Lógicos do Azure multilocatários e Aplicativos Lógicos do Azure de locatário único. Para obter informações técnicas sobre o conector X12 , consulte a seguinte documentação:

• Página de referência do conector, que descreve os gatilhos, ações e limites, conforme documentado pelo arquivo Swagger do conector

• Limites do protocolo B2B para tamanhos de mensagens

Pré-requisitos

• Uma conta e subscrição do Azure. Se ainda não tiver uma subscrição do Azure, inscreva-se numa conta gratuita do Azure.

• Um recurso de conta de integração onde você define e armazena artefatos, como parceiros comerciais, contratos, certificados e assim por diante, para uso em sua integração empresarial e fluxos de trabalho B2B. Este recurso tem de cumprir os seguintes requisitos:

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

  • Define pelo menos dois parceiros comerciais que participam da operação X12 usada em seu fluxo de trabalho. As definições para ambos os parceiros devem usar o mesmo qualificador de identidade comercial X12.

  • Define um contrato X12 entre os parceiros comerciais que participam do seu fluxo de trabalho. Cada acordo requer um parceiro anfitrião 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 de contrato a serem usadas ao receber e enviar mensagens, consulte Configurações de mensagem X12.

    Importante

    Se estiver a trabalhar com esquemas HIPAA (Health Insurance Portability and Accountability Act), tem de adicionar uma schemaReferences secção ao seu contrato. Para obter mais informações, consulte Esquemas e tipos de mensagem HIPAA.

  • Define os esquemas a serem usados para validação XML.

    Importante

    Se você estiver trabalhando com esquemas HIPAA (Health Insurance Portability and Accountability Act), certifique-se de revisar os esquemas e os tipos de mensagem da HIPAA.

• Com base no fato de você estar trabalhando em um fluxo de trabalho de aplicativo lógico de consumo ou padrão, seu recurso de aplicativo lógico pode exigir um link para sua conta de integração:

  Fluxo de trabalho do aplicativo lógico	Link necessário?
  Consumo	Conexão e 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	Conexão com a conta de integração necessária, mas nenhum link necessário. 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 onde você deseja usar as operações X12.

  Para obter mais informações, veja a seguinte documentação:

  • Criar um exemplo de fluxo de trabalho de aplicativo lógico de consumo em Aplicativos Lógicos do Azure multilocatário

  • Criar um exemplo de fluxo de trabalho de aplicativo lógico padrão em Aplicativos Lógicos do Azure de locatário único

Codificar mensagens X12

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

• Resolve o contrato combinando 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 segmentos de cabeçalho e reboque 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 de carga útil.
• Valida EDI e propriedades específicas do parceiro.
  • Validação de esquema de elementos de dados do conjunto de transações em relação ao esquema de mensagem.
  • Validação EDI em elementos de dados do conjunto de transações.
  • Validação estendida em elementos de dados de conjunto de transações.
• Solicita um Reconhecimento Técnico e Funcional, se configurado.
  • Gera um Reconhecimento Técnico como resultado da validação do cabeçalho. O reconhecimento técnico informa o status do processamento de um cabeçalho de intercâmbio e reboque pelo recetor de endereço.
  • Gera um Reconhecimento Funcional como resultado da validação corporal. O reconhecimento funcional relata cada erro encontrado durante o processamento do documento recebido.

Descodificar mensagens X12

A operação de mensagem Decode X12 executa as seguintes tarefas:

• Valida o envelope em relação ao contrato de parceiro comercial.

• Valida EDI e propriedades específicas do parceiro.

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

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

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

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

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

  • Divida o intercâmbio em conjuntos de transações ou suspenda o intercâmbio em caso de erro: analise 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 produzirá todos os conjuntos de transações nesse intercâmbio para badMessages.

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

  • Preservar o intercâmbio ou suspender o intercâmbio em caso de erro: Preserve o intercâmbio e processe 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 produzirá todos os conjuntos de transações nesse intercâmbio para badMessages.

• Gera um Reconhecimento Técnico e Funcional, se configurado.

  • Gera um Reconhecimento Técnico como resultado da validação do cabeçalho. O reconhecimento técnico informa o status do processamento de um cabeçalho de intercâmbio e reboque pelo recetor de endereço.
  • Gera um Reconhecimento Funcional como resultado da validação corporal. O reconhecimento funcional relata cada erro encontrado durante o processamento do documento recebido.

Próximos passos

• Agradecimentos técnicos e códigos de erro X12 TA1
• X12 997 reconhecimentos funcionais e códigos de erro
• Configurações de mensagem X12