Категория:SBIS API3

Описание порядка синхронизации внешней системы с СБИС.

Данный API позволяет реализовать двустороннюю автоматическую синхронизировать объектов СБИС с внешней системой.

Термины:

Connection - объект содержащий параметры синхронизации и настройки подключения, любая интеграция с внешней системой начинается с создания подключения к внешней системы через мастер в интерфейсе СБИС. ExtSyncDoc - объект содержащий данные одной итерации синхронизации - Список объектов синхронизации (ExtSyncObj) и направление обмена. ExtSybcObj - данные объекта синхронизации.

Порядок действий внешней системы для синхронизации данных с СБИС.

Создать ExtSyncDoc и поместить в него все изменившиеся в ИС объекты. Для созданного ExtSyncDoc вызывать метод Prepare. Данный метод несколькими итерациями (для вывода прогресс бара) проанализирует список объектов которые необходимо загрузить, и выдаст список вложенных объектов, которых не хватает для успешной загрузки. Внешняя система добавляет в этот ExtSyncDoc необходимые объекты и при помощи метода Prepare добивается, чтобы все необходимые данные были переданы. После того как все данные загружены вызывает для ExtSyncDoc асинхронный метод метод Execute, который обновит в СБИС все указанные в ExtSyncDoc объекты. Для двухсторонней синхронизации необходимо от ExtSyncDoc вызвать асинхронный метод getChanges, который добавит с данный документ список изменений со стороны СБИС и пометит конфликтные записи (записи у которых есть изменения с обеих сторон). Для разрешения конфликтов в СБИС есть соответствующий интерфейс доступный в истории синхронизации.

Получить данные для обновления во внешней системе, можно при помощи метода Read у объекта ExtSyncDoc с фильтром по направлению Export.