Referência para configurações de mensagem X12 em contratos para Aplicativos Lógicos do Azure

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

Esta referência descreve as propriedades que você pode definir em um contrato X12 para especificar como lidar com mensagens entre parceiros comerciais. Configure estas propriedades com base no seu contrato com o parceiro que troca mensagens consigo.

Configurações de recebimento do X12

Identifiers

Property	Description
ISA1 (Qualificador de Autorização)	O valor do Qualificador de Autorização que você deseja usar. O valor padrão é 00 - Nenhuma informação de autorização presente. Nota: Se você selecionar outros valores, especifique um valor para a propriedade ISA2 .
ISA2	O valor Informações de Autorização a ser usado quando a propriedade ISA1 não for 00 - Nenhuma Informação de Autorização Presente. Este valor de propriedade deve ter um mínimo de um caractere alfanumérico e um máximo de 10.
ISA3 (Qualificador de Segurança)	O valor do Qualificador de Segurança que você deseja usar. O valor padrão é 00 - Nenhuma informação de segurança presente. Nota: Se você selecionar outros valores, especifique um valor para a propriedade ISA4 .
ISA4	O valor de Informações de Segurança a ser usado quando a propriedade ISA3 não for 00 - Nenhuma Informação de Segurança Presente. Este valor de propriedade deve ter um mínimo de um caractere alfanumérico e um máximo de 10.

Confirmação

Property	Description
TA1 Esperado	Retornar uma confirmação técnica (TA1) ao remetente do intercâmbio.
FA Esperado	Retornar uma confirmação funcional (FA) para o remetente do intercâmbio. Para a propriedade FA Version , com base na versão do esquema, selecione as confirmações 997 ou 999. Para habilitar a geração de loops AK2 em reconhecimentos funcionais para conjuntos de transações aceitos, selecione Incluir loop AK2 / IK2.

Esquemas

Para esta seção, selecione um esquema da sua conta de integração para cada tipo de transação (ST01) e Aplicativo de Remetente (GS02). O pipeline de recebimento EDI desmonta a mensagem de entrada fazendo a correspondência entre os valores e o esquema definidos nesta seção com os valores de ST01 e GS02 na mensagem de entrada e com o esquema da mensagem de entrada. Depois de concluir cada linha, uma nova linha vazia aparece automaticamente.

Property	Description
Versão	A versão X12 para o esquema
Tipo de transação (ST01)	O tipo de transação
Aplicativo do remetente (GS02)	O aplicativo remetente
Esquema	O arquivo de esquema que você deseja usar

Envelopes

Property

Description

Utilização do ISA11

O separador a ser usado em um conjunto de transações: - Identificador padrão: use um ponto (.) para notação decimal, em vez da notação decimal do documento de entrada no pipeline de recebimento EDI. - Separador de repetição: especifique o separador para ocorrências repetidas de um elemento de dados simples ou de uma estrutura de dados repetida. Por exemplo, geralmente o quilate (^) é usado como separador de repetição. Para esquemas HIPAA, você só pode usar o quilate.

Números de controlo

Property	Description
Não permitir duplicatas do número de controle de intercâmbio	Bloqueie intercâmbios duplicados. Verifique o número de controlo de intercâmbio (ISA13) para obter o número de controlo de intercâmbio recebido. Se uma correspondência for detetada, o pipeline de recebimento EDI não processará o intercâmbio. Para especificar o número de dias para executar a verificação, insira um valor para a propriedade Check for duplicate ISA13 every (days).
Não permitir duplicatas do número de controle de grupo	Bloqueie intercâmbios que tenham números de controle de grupo duplicados.
Não permitir duplicatas do número de controle do conjunto de transações	Bloqueie intercâmbios com números de controle de conjunto de transações duplicados.

Validações

A linha Padrão mostra as regras de validação usadas para um tipo de mensagem EDI. Se quiser definir regras diferentes, selecione cada caixa onde deseja que a regra seja definida como true. Depois de concluir cada linha, uma nova linha vazia aparece automaticamente.

Property	Description
Tipo de mensagem	O tipo de mensagem EDI
Validação EDI	Execute a validação EDI em tipos de dados conforme definido pelas propriedades EDI do esquema, restrições de comprimento, elementos de dados vazios e separadores à direita.
Validação estendida	Se o tipo de dados não for EDI, a validação estará no requisito do elemento de dados e permitirá repetição, enumerações e validação do comprimento do elemento de dados (min ou max).
Permitir zeros à esquerda/à direita	Mantenha todos os caracteres de zero e espaço à esquerda ou à direita adicionais. Não remova esses caracteres.
Cortar zeros à frente/à direita	Remova todos os caracteres zero e espaço à esquerda ou à direita.
Política de separação à direita	Gere separadores à direita. - Não permitido: Proibir delimitadores e separadores à direita no intercâmbio de entrada. Se o intercâmbio tiver delimitadores e separadores à direita, o intercâmbio é declarado inválido. - Opcional: Aceita intercâmbios com ou sem delimitadores e separadores à direita. - Obrigatório: O intercâmbio de entrada deve ter delimitadores e separadores de fuga.

Configurações internas

Property	Description
Converter formato decimal implícito Nn para um valor numérico base 10	Converta um número EDI especificado com o formato "Nn" em um valor numérico de base 10.
Criar marcas XML vazias se separadores à direita forem permitidos	Peça ao remetente do intercâmbio que inclua marcas XML vazias para separadores à direita.
Split Interchange como conjuntos de transações - suspenda conjuntos de transações em caso de erro	Analise cada conjunto de transações que está em um intercâmbio em um documento XML separado aplicando o envelope apropriado ao conjunto de transações. Suspenda apenas as transações em que a validação falhar.
Split Interchange como conjuntos de transações - suspenda o intercâmbio em caso de erro	Analise cada conjunto de transações que está em um intercâmbio em um documento XML separado aplicando o envelope apropriado. Suspenda todo o intercâmbio quando um ou mais conjuntos de transações no intercâmbio falharem na validação.
Preservar intercâmbio - suspender conjuntos de transações em caso de erro	Deixe o intercâmbio intacto e crie um documento XML para todo o intercâmbio em lote. Suspenda apenas os conjuntos de transações que falharem na validação, mas continue a processar todos os outros conjuntos de transações.
Preservar o intercâmbio - suspender o intercâmbio em caso de erro	Deixa o intercâmbio intacto, cria um documento XML para todo o intercâmbio em lote. Suspende todo o intercâmbio quando um ou mais conjuntos de transações no intercâmbio falham na validação.

X12 Configurações de envio

Identifiers

Property	Description
ISA1 (Qualificador de Autorização)	O valor do Qualificador de Autorização que você deseja usar. O valor padrão é 00 - Nenhuma informação de autorização presente. Nota: Se você selecionar outros valores, especifique um valor para a propriedade ISA2 .
ISA2	O valor Informações de Autorização a ser usado quando a propriedade ISA1 não for 00 - Nenhuma Informação de Autorização Presente. Este valor de propriedade deve ter um mínimo de um caractere alfanumérico e um máximo de 10.
ISA3 (Qualificador de Segurança)	O valor do Qualificador de Segurança que você deseja usar. O valor padrão é 00 - Nenhuma informação de segurança presente. Nota: Se você selecionar outros valores, especifique um valor para a propriedade ISA4 .
ISA4	O valor de Informações de Segurança a ser usado quando a propriedade ISA3 não for 00 - Nenhuma Informação de Segurança Presente. Este valor de propriedade deve ter um mínimo de um caractere alfanumérico e um máximo de 10.

Confirmação

Property	Description
TA1 Esperado	Retornar uma confirmação técnica (TA1) ao remetente do intercâmbio. Esta definição especifica que o parceiro anfitrião, que está a enviar a mensagem, solicita uma confirmação do parceiro convidado no contrato. Estes agradecimentos são esperados pelo parceiro anfitrião com base nas Definições de Receção do contrato.
FA Esperado	Retornar uma confirmação funcional (FA) para o remetente do intercâmbio. Para a propriedade FA Version , com base na versão do esquema, selecione as confirmações 997 ou 999. Esta definição especifica que o parceiro anfitrião, que está a enviar a mensagem, solicita uma confirmação do parceiro convidado no contrato. Estes agradecimentos são esperados pelo parceiro anfitrião com base nas Definições de Receção do contrato.

Esquemas

Para esta seção, selecione um esquema da sua conta de integração para cada tipo de transação (ST01). Depois de concluir cada linha, uma nova linha vazia aparece automaticamente.

Property	Description
Versão	A versão X12 para o esquema
Tipo de transação (ST01)	O tipo de transação para o esquema
Esquema	O arquivo de esquema que você deseja usar. Se você selecionar o esquema primeiro, a versão e o tipo de transação serão definidos automaticamente.

Envelopes

Property

Description

Utilização do ISA11

O separador a ser usado em um conjunto de transações: - Identificador padrão: use um ponto (.) para notação decimal, em vez da notação decimal do documento de saída no pipeline de envio EDI. - Separador de repetição: especifique o separador para ocorrências repetidas de um elemento de dados simples ou de uma estrutura de dados repetida. Por exemplo, geralmente o quilate (^) é usado como separador de repetição. Para esquemas HIPAA, você só pode usar o quilate.

Número da versão de controle

Para esta seção, selecione um esquema de sua conta de integração para cada intercâmbio. Depois de concluir cada linha, uma nova linha vazia aparece automaticamente.

Property	Description
Número de versão do controle (ISA12)	A versão do padrão X12
Indicador de utilização (ISA15)	O contexto de um intercâmbio, que é dados de teste, dados de informações ou dados de produção
Esquema	O esquema a ser usado para gerar os segmentos GS e ST para um intercâmbio codificado em X12 que é enviado para o pipeline de envio EDI.
GS1	Opcionalmente, selecione o código funcional.
GS2	Opcional, especifique o remetente do aplicativo.
GS3	Opcional, especifique o recetor do aplicativo.
GS4	Opcional, selecione CCYYMMDD ou YYMMDD.
GS5	Opcional, selecione HHMM, HHMMSS ou HHMMSSdd.
GS7	Opcionalmente, selecione um valor para o órgão responsável.
GS8	Opcional, especifique a versão do documento do esquema.

Números de controlo

Property	Description
Número de controle de intercâmbio (ISA13)	O intervalo de valores para o número de controle de intercâmbio, que pode ter um mínimo de valor 1 e um valor máximo de 999999999
Número de controle de grupo (GS06)	O intervalo de valores para o número de controle de grupo, que pode ter um valor mínimo de 1 e um valor máximo de 999999999
Número de controle do conjunto de transações (ST02)	O intervalo de valores para o número de controle do conjunto de transações, que pode ter um valor mínimo de 1 e um valor máximo de 999999999 - Prefixo: Opcional, um valor alfanumérico - Sufixo: Opcional, um valor alfanumérico

Conjuntos de caracteres e separadores

A linha Padrão mostra o conjunto de caracteres usado como delimitadores para um esquema de mensagem. Se não quiser usar o conjunto de caracteres padrão , você pode inserir um conjunto diferente de delimitadores para cada tipo de mensagem. Depois de concluir cada linha, uma nova linha vazia aparece automaticamente.

Gorjeta

Para fornecer valores de caracteres especiais, edite o contrato como JSON e forneça o valor ASCII para o caractere especial.

Property	Description
Conjunto de caracteres a ser usado	O conjunto de caracteres X12, que é Básico, Estendido ou UTF8.
Esquema	O esquema que você deseja usar. Depois de selecionar o esquema, selecione o conjunto de caracteres que deseja usar, com base nas descrições do separador abaixo.
Tipo de entrada	O tipo de entrada para o conjunto de caracteres
Separador de componentes	Um único caractere que separa elementos de dados compostos
Separador de elementos de dados	Um único caractere que separa elementos de dados simples em dados compostos
Separador de caracteres de substituição	Um caractere de substituição que substitui todos os caracteres separadores nos dados de carga útil ao gerar a mensagem X12 de saída
Terminador de segmento	Um único caractere que indica o final de um segmento EDI
Sufixo	O caractere a ser usado com o identificador de segmento. Se você especificar um sufixo, o elemento de dados do terminador de segmento poderá estar vazio. Se o terminador de segmento for deixado vazio, você deverá designar um sufixo.

Validação

A linha Padrão mostra as regras de validação usadas para um tipo de mensagem EDI. Se quiser definir regras diferentes, selecione cada caixa onde deseja que a regra seja definida como true. Depois de concluir cada linha, uma nova linha vazia aparece automaticamente.

Property	Description
Tipo de mensagem	O tipo de mensagem EDI
Validação EDI	Execute a validação EDI em tipos de dados conforme definido pelas propriedades EDI do esquema, restrições de comprimento, elementos de dados vazios e separadores à direita.
Validação estendida	Se o tipo de dados não for EDI, a validação estará no requisito do elemento de dados e permitirá repetição, enumerações e validação do comprimento do elemento de dados (min ou max).
Permitir zeros à esquerda/à direita	Mantenha todos os caracteres de zero e espaço à esquerda ou à direita adicionais. Não remova esses caracteres.
Cortar zeros à frente/à direita	Remova todos os caracteres zero e espaço à esquerda ou à direita.
Política de separação à direita	Gere separadores à direita. - Não permitido: Proibir delimitadores e separadores de fuga no intercâmbio de saída. Se o intercâmbio tiver delimitadores e separadores à direita, o intercâmbio é declarado inválido. - Opcional: Envie intercâmbios com ou sem delimitadores e separadores à direita. - Obrigatório: O intercâmbio de saída deve ter delimitadores e separadores de fuga.

Esquemas HIPAA e tipos de mensagem

Quando você trabalha com esquemas HIPAA e os tipos de mensagem 277 ou 837, você precisa executar algumas etapas extras. Os números de versão do documento (GS8) para esses tipos de mensagem têm mais de nove caracteres, por exemplo, "005010X222A1". Além disso, alguns números de versão do documento são mapeados para tipos de mensagens variantes. Se você não fizer referência ao tipo de mensagem correto no esquema e no contrato, receberá esta mensagem de erro:

"The message has an unknown document type and did not resolve to any of the existing schemas configured in the agreement."

Esta tabela lista os tipos de mensagem afetados, quaisquer variantes e os números de versão do documento mapeados para esses tipos de mensagem:

Tipo de mensagem ou variante	Description	Número da versão do documento (GS8)
277	Notificação do Estado das Informações sobre Cuidados de Saúde	005010X212
837_I	Reivindicação de Cuidados de Saúde Institucional	004010X096A1 005010X223A1 005010X223A2
837_D	Reivindicação de cuidados de saúde odontológicos	004010X097A1 005010X224A1 005010X224A2
837_P	Profissional de Reclamação de Cuidados de Saúde	004010X098A1 005010X222 005010X222A1

Você também precisa desativar a validação EDI ao usar esses números de versão do documento porque eles resultam em um erro de que o comprimento do caractere é inválido.

Para especificar esses números de versão do documento e tipos de mensagem, execute estas etapas:

Nota

Cada mensagem com 837_P, 837_I ou tipo 837_D requer um contrato separado.

1. No esquema HIPAA, substitua o tipo de mensagem atual pelo tipo de mensagem variante para o número da versão do documento que você deseja usar.

   Por exemplo, suponha que você queira usar o número 005010X222A1 da versão do documento com o tipo de 837 mensagem. No esquema, substitua "X12_00501_837_P" cada "X12_00501_837" valor pelo valor.

   Para atualizar o esquema, siga estes passos:

   1. No portal do Azure, vá para sua conta de integração. Encontre e transfira o seu esquema. Substitua o tipo de mensagem, renomeie o arquivo de esquema e carregue o esquema revisado para sua conta de integração. Para obter mais informações, consulte Editar um esquema.

   2. Nas configurações de mensagem do contrato, selecione o esquema revisado.

2. No objeto do contrato, adicione outra entrada que especifique o tipo de mensagem variante que corresponde ao número da versão do schemaReferences documento.

   Por exemplo, suponha que você queira usar o número 005010X222A1 da versão do documento para o tipo de 837 mensagem. Seu contrato tem uma schemaReferences seção com estas propriedades e valores:

   "schemaReferences": [
      {
         "messageId": "837",
         "schemaVersion": "00501",
         "schemaName": "X12_00501_837"
      }
   ]
   

   Edite sua schemaReferences seção para se parecer com o exemplo a seguir:

   "schemaReferences": [
      {
         "messageId": "837",
         "schemaVersion": "00501",
         "schemaName": "X12_00501_837_P"
      }
   ]
   

3. Nas configurações de mensagem do contrato, desative a validação EDI desmarcando a caixa de seleção Validação EDI para cada tipo de mensagem ou para todos os tipos de mensagem se estiver usando os valores padrão .

   

Próximos passos

Mensagens X12 do Exchange