Перейти к содержанию

Структура пакетов

Формат JSON-конверта описан в разделе Концепции / Структура сообщения обмена. Данная статья описывает, как 1С-модуль формирует и разбирает конверт.

Конверт исходящего сообщения

При отправке модуль собирает следующий JSON:

{
  "Id": "b3d2af76-e80a-44cc-bae7-fa95f49cd75a",
  "Type": "DATA",
  "ClassId": "Catalog_ПричиныДефектов",
  "CreationTime": "2026-02-15T12:34:02",
  "Properties": "",
  "Source": "e7b6294f-e4e1-4151-988d-0806e8922507",
  "Body": {
    "Id": [
      {
        "SystemID": "4b56c685-...",
        "SystemName": "integration_test_user",
        "EntityID": "3905ab28-..."
      },
      {
        "SystemID": "85c5fa29-...",
        "SystemName": "Dev-ERP-RabbitMQ",
        "EntityID": "aadc15df-..."
      }
    ],
    "Наименование": "Задир детали"
  }
}
Поле конверта Источник в 1С
Id Генерируется как Новый УникальныйИдентификатор
Type Всегда "DATA"
ClassId КлассСообщения из описания обработчика
CreationTime ТекущаяДатаСеанса() в формате ISO 8601
Source ИдентификаторСистемы из записи «Эта база» справочника «Интегрируемые системы»
Body Структура, возвращённая исходящим обработчиком
Body.Id Массив идентификаторов объекта из таблицы идентификаторов

Поле Body.Id

Массив Id в Body формируется автоматически вызовом ДатаХабИнтеграция.ДобавитьВСтруктуруЗначениеДляВыгрузки(Результат, "Id", ОбъектОбработки). Модуль читает таблицу идентификаторов и включает пары (SystemID, SystemName, EntityID) для всех известных систем, с которыми обменивались данным объектом.

Разбор входящего конверта

При приёме модуль:

  1. Десериализует JSON в структуру 1С.
  2. Сохраняет конверт целиком в поле Хранилище регистра входящих сообщений.
  3. Извлекает ClassId для определения нужного обработчика.
  4. Передаёт в обработчик:
    • ОбъектОбработки — десериализованное содержимое Body
    • ОбъектСообщение — полный конверт

Поле Body.Id содержит идентификаторы объекта в системах-отправителях и используется алгоритмом идентификации для поиска соответствующего объекта в данной базе.

Типы данных в JSON

Даты передаются в формате ISO 8601: "2026-02-15T12:34:02". При разборе используется ДатаХабИнтеграция.ПолучитьЗначениеПоТипу(Значение, "Дата", ...) для преобразования строки в тип 1С Дата.

Ссылки на объекты других типов передаются как вложенный Id-массив — аналогичной структуры [{SystemID, SystemName, EntityID}].