Расширение для 1С: Комплексная автоматизация

Полное описание всех модулей интеграции 1С Комплексная автоматизация с Цифрой. Расширение реализовано как набор общих модулей с префиксом cf_.

Установка расширения

Скачайте файл расширения и следуйте инструкции ниже
Скачать ИнтеграцияЦифра_Universal.cfe (≈ 223 КБ, формат .cfe)

Перед началом установки:

Убедитесь, что у вас есть права администратора в 1С
Требуется платформа 1С:Предприятие 8.3 (версия 8.3.6 и выше)
Рекомендуется создать резервную копию базы перед установкой

Фаза 1. Загрузка расширения через Конфигуратор

Запустите Конфигуратор
Откройте базу данных в режиме «Конфигуратор».
Откройте управление расширениями
В верхнем меню выберите Конфигурация → Расширения конфигурации.
Создайте новое расширение
В окне «Расширения конфигурации» нажмите Действия → Добавить.
В свойствах расширения измените Назначение на Дополнение.
Выберите созданное расширение
В списке расширений выберите Расширение (оно появится в самом низу списка).
Загрузите конфигурацию из файла
Нажмите Действия → Загрузить конфигурацию из файла…
Укажите путь к скачанному файлу ИнтеграцияЦифра_Universal.cfe и нажмите Открыть.
Подтвердите замену
Система предложит заменить пустое «Расширение» на загруженную конфигурацию — нажмите Да.
Обновите конфигурацию базы данных
В верхнем меню выберите Конфигурация → Обновить конфигурацию базы данных (или нажмите F7).
Дождитесь завершения обновления — это может занять несколько минут.

Фаза 2. Настройка интеграции

Запустите 1С в пользовательском режиме
В верхнем меню выберите Отладка → Начать отладку (или нажмите F5).
Откроется основной интерфейс 1С:Предприятие.
Откройте настройки интеграции
В строке поиска 1С введите Интеграция Цифра и перейдите в найденную обработку.

Заполните параметры подключения

Поле	Значение	Описание
`Секретный код`	Ваш секретный код	Ключ авторизации из Цифры: Настройки → Интеграции → Интеграция с 1С
`Сайт`	`1c.cifra.ai`	Адрес сервера интеграции (без `https://`)

Сохраните настройки
Нажмите кнопку Записать.

Фаза 3. Запуск мониторинга

Откройте регламентные задания
В строке поиска 1С введите Регламентные и фоновые задания.
Дождитесь формирования списка заданий.
Запустите мониторинг
Найдите в списке задание Мониторинг (CF), выберите его и нажмите Выполнить сейчас.
Это запустит первичную синхронизацию с Цифрой. В дальнейшем мониторинг будет работать автоматически.

Готово! После выполнения всех шагов расширение начнёт автоматически синхронизировать данные с Цифрой. Для проверки работоспособности перейдите по адресу https://1c.cifra.ai/get/ВАШ_СЕКРЕТНЫЙ_КОД и убедитесь, что данные поступают.

Возможные проблемы:

Если расширение не отображается — проверьте, что Назначение установлено в Дополнение, а расширение включено
Если данные не отправляются — убедитесь, что компьютер с 1С имеет доступ в интернет и адрес 1c.cifra.ai не заблокирован
Если мониторинг не выполняется — проверьте, что регламентные задания включены в настройках базы
Все операции логируются в журнал регистрации 1С — фильтруйте по событиям «Интеграция Цифра»

Архитектура расширения

Расширение состоит из трёх слоёв:

Слой	Модули	Назначение
Ядро	cf_МодульСервер cf_МодульПовтор cf_МодульJSON	HTTP-взаимодействие, настройки, логирование, работа с JSON
Выгрузка (1С → Цифра)	cf_ВыгрузитьКонтрагенты cf_ВыгрузитьНоменклатура cf_ВыгрузитьДоговораКонтрагентов cf_ВыгрузитьТранспортныеСредства cf_ВыгрузитьФизическиеЛица cf_ВыгрузитьСчетаПокупателю cf_ВыгрузитьЗоныДоставки cf_ВыгрузитьРесурсныеСпецификации	Отправка справочников и документов из 1С на сервер Цифры
Создание (Цифра → 1С)	cf_СоздатьКонтрагента cf_СоздатьДоговор cf_СоздатьТранспортныеСредства cf_СоздатьДокументЗаказ cf_СоздатьДокументРеализация	Создание новых объектов в 1С по командам из Цифры

Как работает синхронизация

Регулярный опрос (polling)

Расширение каждую минуту вызывает процедуру cf_Мониторинг, которая:

Отправляет POST-запрос на /api/check с секретным ключом
Получает массив заданий (Tasks) от сервера
Для каждого задания: ставит статус work, выполняет, ставит done или failed

Автоматическая выгрузка при изменении

При записи элемента справочника срабатывает подписка cf_Справочник_ПриЗаписи, которая запускает фоновую выгрузку изменённого объекта. Поддерживаемые справочники:

Организации (фильтр по массиву организаций из настроек)
Контрагенты
СоглашенияСКлиентами (фильтр: подразделение с флагом cf_ВыгрузитьВЦифру)
Номенклатура
ТранспортныеСредства
ФизическиеЛица
ЗоныДоставки

Пакетная отправка

Все модули выгрузки поддерживают пакетную отправку — данные отправляются порциями по 500 элементов (настраивается параметром МаксКолЭлементов). Это предотвращает таймауты при выгрузке больших справочников.

Настройки расширения

Все настройки хранятся в константе cf_Настройки (тип ХранилищеЗначения). Доступные параметры:

Параметр	По умолчанию	Описание
`СекретныйКод`	пусто	Ключ авторизации для API Цифры
`URL`	1c.cifra.ai	Адрес сервера Цифры
`МаксКолЭлементов`	500	Размер пакета при выгрузке
`СтавкаНДС`	22	Ставка НДС для полей `Vat` и формулы расчёта суммы НДС
`ВременнойИнтервал`	120	Интервал мониторинга (сек)
`МассивОрганизации`	пусто	Фильтр по организациям
`МассивВидыНоменклатуры`	пусто	Фильтр по видам номенклатуры
`ОтборДогворовПоДате`	Да	Фильтрация договоров по дате действия
`ОтборДогворовПоОрганизации`	Да	Фильтрация договоров по организации
`ОсновнойСклад`	пусто	Склад по умолчанию для заказов
`Приоритет`	пусто	Приоритет заказов
`ПериодВыгрузкиДокументовВДнях`	30	Глубина выгрузки документов

Логирование

Расширение ведёт два журнала в регистрах сведений:

cf_ЛогОтправленных — все исходящие запросы (выгрузка справочников). Хранит: UID, дата, данные JSON, результат ответа API.
cf_ЛогПолученных — все входящие задания (создание объектов). Хранит: UID, дата, данные задания, результат выполнения.

Логи автоматически сокращаются до последних 1000 записей при каждой операции.