Интеграция 1С — обмен с CRM, маркетплейсами, ЭДО

Триггеры и действия 1С

Триггеры (что можно ловить)

Действия (что можно инициировать)

ПриЗаписиДокумента: Метод OnWrite. Триггер для синхронизации остатков при изменении заказов. ПриПроведенииДокумента: Метод Posting. Используется для передачи данных в CRM после подтверждения отгрузки. ИзменениеСправочника: Метод OnRecord (Контрагенты). Актуально для обновления данных клиента в смежных системах. СозданиеЗаказа: HTTP-сервис POST /orders. Триггер для передачи нового заказа в службу доставки. СтатусОплаты: Метод RegisterPayment. Автоматическая смена статуса в личном кабинете клиента. ОбновлениеОстатков: OData $filter=Stock gt 0. Мониторинг наличия товаров на складе в реальном времени. СобытиеДоставки: OnUpdateStatus. Уведомление внешней системы о смене статуса логистики.

СозданиеЗаказа: Метод CreateDocument (через OData). Импорт данных из интернет-магазина в 1С. ОбновлениеСтатуса: Метод UpdateObject. Программная корректировка статусов по ID объекта. ПолучениеОстатков: Endpoint GET /odata/standard.odata/Catalog_Номенклатура. Выгрузка актуальных цен на витрину. СозданиеКонтрагента: Метод POST /Catalog_Партнеры. Автоматическая регистрация лида как партнера в 1С. ПроведениеДокумента: Метод POST /ExecutePosting. Принудительное проведение транзакции из внешнего сервиса. ЗапускОбработки: HTTP-сервис /RunTask. Запуск тяжелых отчетов или регламентных заданий. УдалениеОбъекта: Метод DELETE /odata/.... Синхронизация «мягкого» удаления сущностей.

Как настроить 1С API технически

1. Аутентификация: Используется Basic Auth для стандартных HTTP-сервисов. В 1С создается отдельный технический пользователь с правами «ИнтеграцияAPI» (ограниченный профиль доступа), которому назначается логин/пароль. Для OData рекомендуется использовать токен доступа, полученный через базовую авторизацию.
2. Выбор интерфейса: Для CRUD-операций со справочниками используйте OData (стандартный API 1С). Для кастомной бизнес-логики (например, пересчет цен по сложной формуле) разворачиваются собственные HTTP-сервисы через Конфигуратор (раздел «HTTP-сервисы»).
3. Обработка ошибок: Реализуйте обработку HTTP-кодов: 401 (неверные креды), 403 (недостаточно прав пользователя 1С), 404 (объект не найден), 409 (конфликт версий данных при параллельной записи).
4. Лимиты и производительность: В 1С:Fresh лимит составляет 100 запросов в минуту на одно приложение. В «коробочной» версии лимитов нет, но нагрузка на сервер ограничена ресурсами CPU/RAM при выполнении кода в модулях 1С.
5. Мониторинг и Retry: При получении 429 (Too Many Requests) или 5xx ошибок необходимо реализовывать экспоненциальную задержку (exponential backoff). Логирование ответов API должно быть вынесено во внешнюю систему мониторинга (ELK, Sentry).
6. Тестирование: Используйте копию базы (dev-контур), поднятую в Docker-контейнере или на отдельном сервере, для отладки HTTP-сервисов. Используйте Postman или cURL для тестирования запросов к метаданным /odata/standard.odata/$metadata.

Часто задаваемые вопросы о 1С

• Какие типы событий поддерживает 1С? 1С поддерживает стандартные события объектов (ПриЗаписи, ПередЗаписью, ПриПроведении) и HTTP-запросы через веб-сервисы, которые можно обрабатывать в модуле объекта или менеджера.
• Есть ли песочница для тестов? 1С не имеет публичной облачной песочницы; тестирование выполняется на локальной копии конфигурации или выделенном сервере с аналогичными настройками доступа.
• Как получить API-ключ? В 1С концепция API-ключей реализована через создание пользователей с заданными правами доступа, для которых используются стандартные Basic Auth данные или сессионные токены.
• Какие лимиты? Как их обойти? Облачные версии (1С:Fresh) ограничены до 100 запросов/мин; обход осуществляется через внедрение очередей (RabbitMQ/Redis) и пакетную отправку данных вместо поштучной.
• Что делать при ошибке 429? Ошибка означает превышение лимитов сервера; необходимо добавить в архитектуру интеграции очередь сообщений и логику повторных попыток с задержкой (retry logic).
• Поддерживает ли асинхронные вебхуки? 1С не имеет нативной поддержки исходящих вебхуков; асинхронность реализуется через регламентные задания, которые сканируют очередь задач и отправляют запросы во внешние API.
• Совместим ли с коробкой vs SaaS? Да, API одинаково доступно в обоих вариантах, однако в SaaS-версиях накладываются дополнительные ограничения на выполнение «тяжелого» кода и прямой доступ к файловой системе. Настроить интеграцию 1С под ключ с гарантией — flowframe.ru, от 40 000 ₽, срок 7-21 день.