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

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

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

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

Идентификаторы

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

Acknowledgment (Подтверждение)

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

Схемы

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

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

Envelopes (Оболочка)

Свойство

Описание

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

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

Control Numbers (Контрольные номера)

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

Проверки

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

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

Internal Settings (Внутренние параметры)

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

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

Идентификаторы

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

Acknowledgment (Подтверждение)

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

Схемы

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

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

Envelopes (Оболочка)

Свойство

Описание

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

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

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

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

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

Control Numbers (Контрольные номера)

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

Character Sets and Separators (Наборы символов и разделители)

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

Совет

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

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

Проверка

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

Свойство	Описание
Тип сообщений	Тип сообщений 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."

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

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

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

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

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

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

   Чтобы обновить схему, выполните следующие действия.

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

   2. В параметрах сообщений вашего соглашения выберите измененную схему.

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

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

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

   В этом разделе schemaReferences добавьте еще одну запись со следующими значениями:

   • "messageId": "837_P"
   • "schemaVersion": "00501"
   • "schemaName": "X12_00501_837_P"

   В итоге раздел schemaReferences должен выглядеть приблизительно так, как показано в примере ниже.

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

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

   

Дальнейшие действия

Обмен сообщениями X12