Сервисы интеграции и метаданные в 1С: что это и как работает

Метаданные в 1С — это описание структуры прикладного решения: какие в системе есть справочники, документы, регистры, какие у них реквизиты, типы данных и связи. Программа хранит не только сами данные (контрагентов, накладные, проводки), но и «схему» этих данных, и именно метаданные определяют, что можно записать в информационную базу и в каком виде.

Сервисы интеграции — это механизмы, через которые 1С обменивается информацией с внешними системами: сайтами, CRM, банками, маркетплейсами, другими базами 1С. К таким сервисам относятся HTTP-сервисы, веб-сервисы (SOAP), планы обмена, шины данных и типовые подсистемы интеграции вроде «Синхронизация данных» или EnterpriseData.

Эти два понятия тесно связаны: любой обмен данными строится на метаданных. Внешняя система не знает внутреннего устройства базы, поэтому при интеграции объекты метаданных (документ «Реализация товаров», справочник «Номенклатура») преобразуются в нейтральный формат — XML, JSON, пакеты XDTO — и обратно. Понимание этой связки помогает грамотно настроить обмен и находить ошибки, когда данные «не доезжают» или записываются не туда.

Что такое метаданные в 1С простыми словами

Когда разработчик открывает конфигуратор, он видит дерево конфигурации: справочники, документы, регистры сведений и накопления, отчёты, обработки, перечисления. Всё это — объекты метаданных. У каждого объекта есть свойства: имя, синоним, реквизиты с указанием типа (строка, число, дата, ссылка на другой объект), табличные части, движения по регистрам.

Метаданные отделены от собственно данных. Например, метаданные документа «Поступление товаров и услуг» описывают, что у документа есть номер, дата, контрагент и табличная часть с товарами. А конкретные документы, которые проводят пользователи, — это уже данные, записанные по этой «форме». Изменение метаданных (добавление реквизита) меняет структуру хранения и требует обновления конфигурации базы данных.

Для интеграций важно, что метаданные доступны программно. Через объект Метаданные в коде можно обойти все объекты конфигурации, узнать состав реквизитов и типы значений. На этом построены универсальные обмены, выгрузки структуры конфигурации и механизмы сопоставления объектов между разными базами.

Какие сервисы интеграции есть в 1С

Платформа предоставляет несколько встроенных способов обмена, и выбор зависит от задачи: нужен обмен в реальном времени или по расписанию, инициатор — 1С или внешняя система, какой формат удобен второй стороне.

• HTTP-сервисы — 1С сама публикует REST-подобные точки доступа, на которые внешние системы отправляют запросы и получают ответы (обычно JSON). Гибкий и популярный вариант для сайтов и мобильных приложений.
• Веб-сервисы (SOAP) — 1С публикует сервис по стандарту SOAP с WSDL-описанием. Часто используется в корпоративной среде и при интеграции с системами, где SOAP — принятый стандарт.
• Планы обмена — механизм регулярной синхронизации между базами 1С (в том числе распределённые базы и обмен через файлы, FTP, почту). Работает на регистрации изменений.
• Типовые подсистемы — «Синхронизация данных» и формат EnterpriseData в конфигурациях на БСП, обмен с банками (1С:ДиректБанк), обмен с маркетплейсами, ЭДО.
• Внешние источники данных и COM/OLE — прямое подключение к другим базам; применяется реже из-за ограничений по производительности и безопасности.

Отдельно стоит «1С:Шина» и брокеры сообщений (RabbitMQ, Kafka) — они не являются частью платформы, но часто выступают транспортом, когда 1С входит в состав большого интеграционного ландшафта.

Как метаданные участвуют в интеграции

Любой обмен начинается с сопоставления структур. У внешней системы есть своя модель: «заказ», «клиент», «товар». В 1С им соответствуют объекты метаданных: документ «Заказ клиента», справочник «Контрагенты», справочник «Номенклатура». Настройка интеграции — это по сути описание правил: какое поле внешней системы в какой реквизит объекта 1С записывается.

В файловых обменах (конвертация данных, EnterpriseData) структура пакета строится по метаданным: выгружаются имена объектов, реквизитов, типы значений, ссылки. При загрузке приёмник ищет в своих метаданных соответствующие объекты. Если в базе-приёмнике нет нужного реквизита или он называется иначе, данные теряются или обмен падает с ошибкой.

В HTTP-сервисах разработчик обычно вручную формирует JSON, но и здесь опирается на метаданные: перебор реквизитов документа, проверка типов ссылок, чтение табличных частей. Типовые механизмы БСП умеют сериализовать объекты автоматически, обходя метаданные программно.

Как посмотреть метаданные и подготовиться к настройке обмена

Перед настройкой интеграции полезно изучить структуру обеих систем. В 1С это делается через конфигуратор: откройте дерево конфигурации, найдите нужный объект и посмотрите состав реквизитов, их типы и обязательность заполнения. Для типовых конфигураций часть реквизитов добавлена расширениями или подсистемами БСП — это тоже влияет на обмен.

1. 1
   Определите, какие объекты участвуют в обмене: документы, справочники, регистры.
2. 2
   Откройте конфигуратор и зафиксируйте состав реквизитов каждого объекта, включая табличные части.
3. 3
   Составьте таблицу соответствия: поле внешней системы — реквизит объекта 1С — тип данных.
4. 4
   Определите ключи поиска ссылочных объектов (ИНН+КПП для контрагентов, артикул для номенклатуры).
5. 5
   Выберите транспорт: HTTP-сервис, веб-сервис, план обмена или типовая синхронизация.
6. 6
   Настройте обмен на тестовой копии базы и проверьте загрузку на нескольких реальных примерах.

Для быстрого анализа структуры можно использовать код: обход коллекции метаданных позволяет выгрузить список реквизитов объекта в таблицу или файл. Это удобно, когда объектов много и ручной просмотр занял бы слишком много времени.

Для каждого Реквизит Из Метаданные.Документы.РеализацияТоваровУслуг.Реквизиты Цикл
    Сообщить(Реквизит.Имя + " : " + Строка(Реквизит.Тип));
КонецЦикла;

Типовой сценарий: настройка HTTP-сервиса

Рассмотрим практический пример: сайт должен получать из 1С остатки товаров. Для этого в конфигурации создаётся HTTP-сервис с шаблоном URL, например /stock, и методом GET. В модуле сервиса пишется обработчик: запрос к регистру остатков, формирование JSON и возврат ответа.

Ключевые моменты настройки:

• HTTP-сервис публикуется на веб-сервере (IIS или Apache) через публикацию информационной базы — в диалоге публикации есть отдельный флаг для HTTP-сервисов.
• Аутентификация настраивается средствами веб-сервера и прав пользователя, от имени которого выполняется сервис; у этого пользователя должны быть права только на нужные объекты.
• Формат ответа фиксируется в документации для разработчиков сайта: имена полей, типы, поведение при пустом результате.

После публикации сервис проверяется простым запросом из браузера или curl. Если возвращается ошибка 404 — чаще всего сервис не опубликован или неверно указан шаблон URL; ошибка 401/403 указывает на проблему с аутентификацией; ошибка 500 — на исключение в коде обработчика, текст которого виден в журнале регистрации.

Проверка результата и типичные ошибки

После настройки обмена результат нужно проверить на контрольных примерах: создать объект в системе-источнике, выполнить обмен и убедиться, что в приёмнике объект появился с корректными реквизитами, ссылками и без дублей. Для планов обмена дополнительно смотрят регистрацию изменений и протокол обмена; для сервисов — журнал регистрации и логи веб-сервера.

Ограничения и когда нужен специалист

Самостоятельно обычно настраивают типовые обмены: синхронизацию между типовыми конфигурациями, обмен с банком, выгрузку на сайт через готовые модули. Они документированы и работают «из коробки», если версии конфигураций совместимы.

Привлечь разработчика стоит, когда нужен собственный HTTP-сервис, нестандартный формат, обмен с самописной системой или доработка правил конвертации. Ошибки в таких доработках влияют напрямую на учётные данные, поэтому экономия на квалификации здесь часто оборачивается расхождениями в учёте.

Частые вопросы