Справочник по параметрам сообщений X12 в соглашениях для Azure Logic Apps

Статья
12/04/2024

Область применения: Azure Logic Apps (Потребление + Стандартный)

В этой ссылке описываются свойства, которые можно задать в соглашении X12 для указания способа обработки сообщений между торговыми партнерами. Настройте эти свойства в соответствии с вашим соглашением с партнером, с которым вы обмениваетесь сообщениями.

Параметры получения X12

Снимок экрана: параметры соглашения портал Azure и X12 для входящих сообщений.

Identifiers

Свойство	Description
ISA1 (квалификатор авторизации)	Значение квалификатора авторизации, которое вы хотите использовать. Значение по умолчанию — 00 — сведения об авторизации отсутствуют. Примечание. Если выбрать другие значения, укажите значение для свойства ISA2 .
ISA2	Значение данных авторизации, используемое, если свойство ISA1 отличается от 00 — сведения об авторизации отсутствуют. Значение свойства должно включать от 1 до 10 буквенно-цифровых символов.
ISA3 (квалификатор безопасности)	Значение квалификатора безопасности, которое вы хотите использовать. Значение по умолчанию — 00 — сведения о безопасности отсутствуют. Примечание. Если выбрать другие значения, укажите значение для свойства ISA4 .
ISA4	Значение сведений о безопасности, используемое, если свойство ISA3 отличается от 00 — сведения о безопасности отсутствуют. Значение свойства должно включать от 1 до 10 буквенно-цифровых символов.

Подтверждение

Свойство	Description
Ожидается техническое подтверждение (TA1)	Возвращает техническое подтверждение (TA1) отправителю сообщения.
Ожидается функциональное подтверждение (FA)	Возвращает функциональное подтверждение (FA) отправителю сообщения. Для свойства версия FA в зависимости от версии схемы выберите подтверждения 997 или 999. Установите этот флажок, чтобы включить создание циклов AK2 в функциональных подтверждениях для принимаемых наборов транзакций, выберите Включить цикл AK2/IK2.

Свойство

Description

Ожидается техническое подтверждение (TA1)

Возвращает техническое подтверждение (TA1) отправителю сообщения.

Ожидается функциональное подтверждение (FA)

Возвращает функциональное подтверждение (FA) отправителю сообщения.

Для свойства версия FA в зависимости от версии схемы выберите подтверждения 997 или 999.

Установите этот флажок, чтобы включить создание циклов AK2 в функциональных подтверждениях для принимаемых наборов транзакций, выберите Включить цикл AK2/IK2.

Схемы

В этом разделе выберите схему из учетной записи интеграции для каждого типа транзакции (ST01) и приложения отправителя (GS02). Конвейер получения EDI будет разбирать входящие сообщения, сопоставляя заданные здесь значения и схему со значениями ST01 и GS02 во входящем сообщении и схемой входящего сообщения. После заполнения каждой строки автоматически будет добавляться новая строка.

Свойство	Description
Версия	Версия X12 для схемы.
Тип транзакции (ST01)	Тип транзакции.
Приложение отправителя (GS02)	Приложение отправителя.
Схема	Файл схемы для использования.

Оболочки

Свойство	Description
Использование ISA11	Разделитель, используемый в наборе транзакций: - Стандартный идентификатор: используйте период (.) для десятичной нотации, а не десятичную нотацию входящего документа в конвейере получения EDI. - Разделитель повторений: укажите разделитель для повторяющихся вхождений простого элемента данных или повторяющейся структуры данных. Например, в качестве разделителя повторений обычно используется карет (^). Для схем HIPPA можно использовать только карет.

Свойство

Description

Использование ISA11

Разделитель, используемый в наборе транзакций:

- Стандартный идентификатор: используйте период (.) для десятичной нотации, а не десятичную нотацию входящего документа в конвейере получения EDI.

- Разделитель повторений: укажите разделитель для повторяющихся вхождений простого элемента данных или повторяющейся структуры данных. Например, в качестве разделителя повторений обычно используется карет (^). Для схем HIPPA можно использовать только карет.

Контрольные номера

Свойство	Description
Запретить повторяющиеся контрольные номера обмена	Запрещает повторяющиеся операции обмена. Сверяет контрольный номер операции обмена (ISA13) с контрольными номерами уже полученных операций. Если они совпадают, то конвейер получения EDI не обрабатывает обмен. Чтобы указать длительность периода (в днях), за который выполняется проверка, задайте значение свойства Проверять наличие повторяющегося ISA13 каждые (дн.).
Запретить повторяющиеся контрольные номера групп	Запрещает операции обмена с повторяющимися контрольными номерами групп.
Запретить повторяющиеся контрольные номера наборов транзакций	Запрещает операции обмена с повторяющимися контрольными номерами наборов транзакций.

Проверки

В строке По умолчанию отображаются правила проверки, используемые для типа сообщений EDI. Если необходимо определить иные правила, выберите каждое поле, в котором набор правил должен быть установлен на true. После заполнения каждой строки автоматически будет добавляться новая строка.

Свойство	Description
Тип сообщений	Тип сообщений EDI
Проверка EDI	Выполняет проверку EDI для типов данных в соответствии со свойствами EDI схемы, ограничениями длины, пустыми элементами данных и конечными разделителями.
Расширенная проверка	Если типом данных не является EDI, то проверка проводится согласно требованиям к элементу данных и разрешены повторы, перечисления и контроль длины элементов данных (минимальная и максимальная длина).
Разрешить начальные и конечные нули	Сохраняет все дополнительные начальные или конечные нули и пробелы. Не удаляйте эти символы.
Обрезать начальные и конечные нули	Удаляет все начальные или конечные нули и пробелы.
Политика конечных разделителей	Создает конечные разделители. - Запрещено. Запретить конечные разделители и разделители в входящего обмена. Если обмен содержит конечные разделители, он будет объявлен недопустимым. - Необязательно. Примите обмены с конечными разделителями и разделителями или без нее. - Обязательный: входящий обмен должен иметь конечные разделители и разделители.

Внутренние параметры

Свойство	Description
Преобразовать подразумеваемый десятичный формат Nn в числовое значение с основанием 10	Преобразует число EDI, которое указано в формате Nn, в числовое значение с основанием 10.
Создать пустые теги XML, если конечные разделители разрешены	Используется чтобы отправитель при обмене добавлял пустые теги XML для конечных разделителей.
Разделение документа Interchange на наборы транзакций — заблокировать наборы транзакций при ошибке	Указывает, что каждый набор транзакций в рамках операции обмена нужно анализировать в виде отдельного XML-документа, применяя к этому набору транзакций соответствующую оболочку. Приостанавливаются только те транзакции, для которых происходит сбой проверки.
Разделение документа Interchange на наборы транзакций — заблокировать документ Interchange при ошибке	Указывает, что каждый набор транзакций в рамках операции обмена нужно анализировать в виде отдельного XML-документа, применяя соответствующую оболочку. Если один или несколько наборов транзакций, входящих в обмен, не проходят проверку, обработка останавливается для всего обмена.
Сохранение документа Interchange — заблокировать наборы транзакций при ошибке	Сохраняет операцию обмена неделимой и создает XML-документ для всего пакетного обмена. Обработка будет прекращаться только для тех наборов транзакций, которые не прошли проверку, и продолжится для всех остальных наборов транзакций.
Сохранение документа Interchange — заблокировать операцию обмена при ошибке	Сохраняет операцию обмена неделимой, создавая XML-документ для всего пакетного обмена. Если один или несколько наборов транзакций, входящих в обмен, не проходят проверку, обработка останавливается для всего обмена.

Параметры отправки X12

Снимок экрана: параметры соглашения портал Azure и X12 для исходящих сообщений.

Identifiers

Свойство	Description
ISA1 (квалификатор авторизации)	Значение квалификатора авторизации, которое вы хотите использовать. Значение по умолчанию — 00 — сведения об авторизации отсутствуют. Примечание. Если выбрать другие значения, укажите значение для свойства ISA2 .
ISA2	Значение данных авторизации, используемое, если свойство ISA1 отличается от 00 — сведения об авторизации отсутствуют. Значение свойства должно включать от 1 до 10 буквенно-цифровых символов.
ISA3 (квалификатор безопасности)	Значение квалификатора безопасности, которое вы хотите использовать. Значение по умолчанию — 00 — сведения о безопасности отсутствуют. Примечание. Если выбрать другие значения, укажите значение для свойства ISA4 .
ISA4	Значение сведений о безопасности, используемое, если свойство ISA3 отличается от 00 — сведения о безопасности отсутствуют. Значение свойства должно включать от 1 до 10 буквенно-цифровых символов.

Подтверждение

Свойство	Description
Ожидается техническое подтверждение (TA1)	Возвращает техническое подтверждение (TA1) отправителю сообщения. Этот параметр указывает, что главный партнер, отправляющий сообщение, запрашивает подтверждение от гостевого партнера в соглашении. Эти подтверждения ожидаются главным партнером согласно параметрам получения в соглашении.
Ожидается функциональное подтверждение (FA)	Возвращает функциональное подтверждение (FA) отправителю сообщения. Для свойства версия FA в зависимости от версии схемы выберите подтверждения 997 или 999. Этот параметр указывает, что главный партнер, отправляющий сообщение, запрашивает подтверждение от гостевого партнера в соглашении. Эти подтверждения ожидаются главным партнером согласно параметрам получения в соглашении.

Свойство

Description

Ожидается техническое подтверждение (TA1)

Возвращает техническое подтверждение (TA1) отправителю сообщения.

Этот параметр указывает, что главный партнер, отправляющий сообщение, запрашивает подтверждение от гостевого партнера в соглашении. Эти подтверждения ожидаются главным партнером согласно параметрам получения в соглашении.

Ожидается функциональное подтверждение (FA)

Возвращает функциональное подтверждение (FA) отправителю сообщения. Для свойства версия FA в зависимости от версии схемы выберите подтверждения 997 или 999.

Этот параметр указывает, что главный партнер, отправляющий сообщение, запрашивает подтверждение от гостевого партнера в соглашении. Эти подтверждения ожидаются главным партнером согласно параметрам получения в соглашении.

Схемы

В этом разделе выберите схему из учетной записи интеграции для каждого типа транзакции (ST01). После заполнения каждой строки автоматически будет добавляться новая строка.

Свойство	Description
Версия	Версия X12 для схемы.
Тип транзакции (ST01)	Тип транзакции для схемы.
Схема	Файл схемы для использования. Если сначала выбрать схему, версия и тип транзакции будут настроены автоматически.

Оболочки

Свойство	Description
Использование ISA11	Разделитель, используемый в наборе транзакций: - Стандартный идентификатор: используйте период (.) для десятичной нотации, а не десятичную нотацию исходящего документа в конвейере отправки EDI. - Разделитель повторений: укажите разделитель для повторяющихся вхождений простого элемента данных или повторяющейся структуры данных. Например, в качестве разделителя повторений обычно используется карет (^). Для схем HIPPA можно использовать только карет.

Свойство

Description

Использование ISA11

Разделитель, используемый в наборе транзакций:

- Стандартный идентификатор: используйте период (.) для десятичной нотации, а не десятичную нотацию исходящего документа в конвейере отправки EDI.

- Разделитель повторений: укажите разделитель для повторяющихся вхождений простого элемента данных или повторяющейся структуры данных. Например, в качестве разделителя повторений обычно используется карет (^). Для схем HIPPA можно использовать только карет.

Контрольный номер версии

В этом разделе выберите схему из учетной записи интеграции для каждого обмена. После заполнения каждой строки автоматически будет добавляться новая строка.

Свойство	Description
Контрольный номер версии (ISA12)	Версия стандарта X12.
Индикатор использования (ISA15)	Контекст обмена: Тестовые данные, Информационные данные или Рабочие данные.
Схема	Схема, используемая для создания сегментов GS и ST для обмена в кодировке X12, которые отправляются в конвейер отправки EDI.
GS1	(Необязательно.) Выберите функциональный код.
GS2	(Необязательно.) Укажите отправителя приложения.
GS3	(Необязательно.) Укажите получателя приложения.
GS4	(Необязательно.) Выберите формат CCYYMMDD или YYMMDD.
GS5	(Необязательно.) Выберите формат HHMM, HHMMSS или HHMMSSdd.
GS7	(Необязательно.) Выберите значение ответственного агентства.
GS8	(Необязательно.) Укажите версию документа схемы.

Контрольные номера

Свойство	Description
Контрольный номер обмена (ISA13)	Диапазон значений для контрольного номера обмена, который может иметь минимальное значение, равное 1, и максимальное значение 999999999.
Контрольный номер группы (GS06)	Диапазон значений для контрольного номера группы, который может иметь минимальное значение, равное 1, и максимальное значение 999999999.
Контрольный номер набора транзакций (ST02)	Диапазон значений для контрольного номера набора транзакций, который может иметь минимальное значение 1 и максимальное значение 999999999 - Префикс: необязательное буквенно-цифровое значение - Суффикс: необязательное буквенно-цифровое значение

Наборы символов и разделители

Строка По умолчанию показывает набор символов, используемый в качестве разделителей для схемы сообщений. Если вы не хотите использовать набор символов По умолчанию, можно ввести отличающийся набор разделителей для каждого типа сообщений. После заполнения каждой строки автоматически будет добавляться новая строка.

Совет

Чтобы ввести значения со специальными знаками, откройте соглашение в редакторе как JSON-файл и укажите значение ASCII для специального знака.

Свойство	Description
Используемый набор символов	Набор символов X12, возможные наборы: Базовый, Расширенный или UTF8.
Схема	Схема для использования. После выбора схемы выберите нужный набор символов на основе приведенных ниже описаний разделителей.
Тип входных данных	Тип входных данных для набора символов.
Разделитель компонентов	Одиночный символ, разделяющий составные элементы данных.
Разделитель элементов данных	Одиночный символ, разделяющий простые элементы данных в составных элементах данных.
Разделитель символов замены	Символ замены, которым будут заменены все символы разделителей в полезных данных при создании исходящего сообщения X12.
Признак конца сегмента	Одиночный символ, обозначающий конец сегмента EDI.
Суффикс	Символ, который будет использоваться с идентификатором сегмента. Если указать суффикс, элемент данных признака конца сегмента может быть пустым. Если признак конца сегмента оставить пустым, необходимо будет указать суффикс.

Проверка

Свойство	Description
Тип сообщений	Тип сообщений EDI
Проверка EDI	Выполняет проверку EDI для типов данных в соответствии со свойствами EDI схемы, ограничениями длины, пустыми элементами данных и конечными разделителями.
Расширенная проверка	Если типом данных не является EDI, то проверка проводится согласно требованиям к элементу данных и разрешены повторы, перечисления и контроль длины элементов данных (минимальная и максимальная длина).
Разрешить начальные и конечные нули	Сохраняет все дополнительные начальные или конечные нули и пробелы. Не удаляйте эти символы.
Обрезать начальные и конечные нули	Удаляет все начальные или конечные нули и пробелы.
Политика конечных разделителей	Создает конечные разделители. - Запрещено. Запретить конечные разделители и разделители в исходящем обмене. Если обмен содержит конечные разделители, он будет объявлен недопустимым. - Необязательно. Отправка обменов с конечными разделителями и разделителями без нее. - Обязательный: исходящий обмен должен иметь конечные разделители и разделители.

Схемы и типы сообщений HIPAA

При работе со схемами HIPAA и типами сообщений 277 или 837 необходимо выполнить несколько дополнительных действий. Номера версий документа (GS8) для этих типов сообщений содержат более 9 символов, например "005010X222A1". Кроме того, некоторые номера версий документа сопоставляются с вариантами типов сообщений. Если не сослаться на правильный тип сообщений в схеме и в вашем соглашении, отобразится следующее сообщение об ошибке:

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

В этой таблице перечислены затронутые типы сообщений, любые их варианты и номера версий документов, которые сопоставляются с этими типами сообщений.

Тип сообщения или вариант типа	Description	Текущий номер версии (GS8)
277	Уведомление о состоянии сведений о здоровье	005010X212
837_I	Заявка на получение услуг учреждения здравоохранения	004010X096A1 005010X223A1 005010X223A2
837_D	Заявка на получение стоматологических услуг	004010X097A1 005010X224A1 005010X224A2
837_P	Заявка на получение медицинских услуг специалиста	004010X098A1 005010X222 005010X222A1

Также необходимо отключить проверку EDI при использовании этих номеров версий документа, так как они приводят к ошибке, указывающей на недопустимую длина символа.

Чтобы указать эти номера версий документа и типы сообщений, выполните следующие действия.

Примечание.

Для каждого сообщения с 837_P, 837_I или типа 837_D требуется отдельное соглашение.

В схеме HIPAA замените текущий тип сообщения на вариант типа сообщения для номера версии документа, которую хотите использовать.

Например, предположим, что вы хотите использовать номер версии документа 005010X222A1 с типом сообщений 837. В схеме вместо этого замените каждое значение "X12_00501_837" на "X12_00501_837_P".

Чтобы обновить схему, выполните следующие действия.
1. На портале Azure перейдите в свою учетную запись интеграции. Найдите и скачайте свою схему. Замените тип сообщения, переименуйте файл схемы и отправьте измененную схему в учетную запись интеграции. Дополнительные сведения см. в статье Редактирование схемы.
2. В параметрах сообщений вашего соглашения выберите измененную схему.
В объекте schemaReferences соглашения добавьте еще одну запись, указывающую вариант типа сообщения, соответствующий номеру версии документа.

Например, предположим, что вы хотите использовать номер версии документа 005010X222A1 с типом сообщений 837. В соглашении имеется раздел schemaReferences с этими свойствами и значениями.
```
"schemaReferences": [
   {
      "messageId": "837",
      "schemaVersion": "00501",
      "schemaName": "X12_00501_837"
   }
]
```
schemaReferences Измените раздел, чтобы выглядеть следующим образом:
```
"schemaReferences": [
   {
      "messageId": "837",
      "schemaVersion": "00501",
      "schemaName": "X12_00501_837_P"
   }
]
```
В параметрах сообщения в соглашении отключите проверку EDI, сняв флажок Проверка EDI флажка для каждого из типов сообщений или для всех типов сообщений, если используются значения По умолчанию.

Следующие шаги

Сообщения Exchange X12

Поделиться через

Справочник по параметрам сообщений X12 в соглашениях для Azure Logic Apps

Параметры получения X12

Identifiers

Подтверждение

Схемы

Оболочки

Контрольные номера

Проверки

Внутренние параметры

Параметры отправки X12

Identifiers

Подтверждение

Схемы

Оболочки

Контрольный номер версии

Контрольные номера

Наборы символов и разделители

Проверка

Схемы и типы сообщений HIPAA

Следующие шаги

Обратная связь

Дополнительные ресурсы