Интеграция с 1С: типовые сценарии, способы и подводные камни

Зачем бизнесу интеграция с 1С

Интеграция с 1С нужна, чтобы сотрудники не вводили одни и те же данные дважды, а система учёта и рабочие инструменты показывали одинаковые цифры. Обычно в 1С лежат номенклатура, остатки, цены, контрагенты и взаиморасчёты, а продажи и общение с клиентами идут в CRM, на сайте или в приложении.

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

Типовые сценарии обмена с 1С

Большинство проектов сводится к пяти сценариям. Они отличаются направлением данных и тем, насколько критична задержка.

• CRM и 1С. Контрагенты, сделки, счета и оплаты. Менеджер видит статус оплаты и отгрузки, не открывая учётную систему.
• Сайт или интернет-магазин и 1С. Из 1С уходят каталог, цены и остатки, обратно приходят заказы.
• Маркетплейс и 1С. Заказы, остатки и цены проходят через API площадки. Часто между ними ставят промежуточный сервис, потому что у площадки свои справочники и лимиты запросов.
• Мобильное приложение и 1С. Торговые представители, курьеры или клиенты получают данные через отдельный API, а не напрямую из базы.
• Электронный документооборот. Счета-фактуры из учётной системы уходят оператору ЭДО.

Для Узбекистана последний сценарий особенно важен. По данным Налогового комитета, электронные счета-фактуры обязательны для хозяйствующих субъектов с 1 января 2020 года, а работа с ними допускает интеграцию с бухгалтерскими и биллинговыми программами. В перечне на сайте комитета больше двух десятков операторов, поэтому совместимость выбранного оператора с вашей конфигурацией стоит проверить до старта.

Какие способы интеграции есть у 1С

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

Несколько деталей, которые влияют на выбор:

• REST-интерфейс работает только после публикации базы на веб-сервере. По описанию 1С, через него доступны практически все основные объекты конфигурации, а также некоторые действия, например проведение документа.
• Проверка заполнения отключена. При записи через REST платформа проверяет права и вызывает обработчики событий, но не выполняет проверку заполнения. Обязательные поля и бизнес-правила придётся контролировать на стороне интеграции.
• HTTP-сервисы разработчик проектирует сам: шаблоны URL, методы и формат ответа. В 1С отмечают, что по сравнению с SOAP они проще для клиента и потенциально передают меньше данных, что особенно важно для мобильных приложений.
• Готовый коннектор проверяйте по списку. На странице интеграции Битрикс24 перечислены конфигурации для России, Беларуси и Казахстана, а версий для Узбекистана в этом списке нет. Если у вас локальная конфигурация, совместимость нужно подтвердить заранее или закладывать свой обмен.

Где теряются данные: подводные камни

Большинство сбоев возникает не в момент подключения, а на границах процессов: при дублях, повторах и одновременных правках. Ниже — ситуации, которые стоит разобрать ещё на этапе проектирования.

• Нет главной системы. Если клиента редактируют и в CRM, и в 1С, при обмене одно изменение может затереть другое. Для каждого поля назначьте систему-источник.
• Сопоставление по названию. «ООО Ромашка» и «Ромашка, ООО» становятся двумя контрагентами. Сопоставляйте по ИНН, артикулу или внешнему идентификатору; EnterpriseData и CommerceML используют для этого GUID.
• Повторная отправка. Если ответ потерялся, система отправит заказ ещё раз, и в 1С появится второй документ. Обмен должен быть идемпотентным: перед созданием проверяйте внешний идентификатор.
• Разные справочники. Единицы измерения, склады, статусы и ставки НДС называются в системах по-разному. Без таблицы соответствий записи не загрузятся или попадут не туда.
• Частичные операции. Частичная оплата, возврат, отмена после отгрузки и правка проведённого документа редко попадают в первую версию, зато встречаются в работе каждый месяц.
• Частый опрос. Опрашивать 1С без необходимости — значит нагружать базу. Передавайте только изменения; в EnterpriseData квитирование показывает, какие изменения уже синхронизированы.
• Обновления конфигурации. Переименованное поле или новая версия формата ломает обмен. Описание EnterpriseData на ИТС указывает гарантированный срок поддержки актуальной версии — 1 год с выхода новой версии формата.
• Тихие ошибки. Если журнал обмена никто не смотрит, о сбое узнают от клиента. Нужны оповещения и понятный владелец процесса.

Как тестировать интеграцию

Интеграцию проверяют не только на успешном сценарии: сбои и повторы важнее обычного прохода. Для этого нужна тестовая копия базы 1С с реальными справочниками и примерами документов, иначе расхождения в данных всплывут только в рабочем контуре.

Минимальный набор проверок:

1. Чистый проход. Заказ из CRM или с сайта становится документом в 1С, а статус оплаты возвращается обратно.
2. Повтор. Одно и то же сообщение отправляется дважды, и второй документ не создаётся.
3. Недоступность. 1С или внешняя система отключены на время обмена; после восстановления данные доходят без потерь и дублей.
4. Конфликт. Одна запись меняется в двух системах одновременно, и срабатывает заранее согласованное правило.
5. Плохие данные. Пустое обязательное поле, неизвестная единица измерения, неверный ИНН: запись попадает в журнал ошибок, а не исчезает.
6. Объём. Первая загрузка всего каталога и пиковое число заказов не мешают работе пользователей 1С.
7. Сверка. Итоги за период в обеих системах совпадают.

Запускать лучше по одному маршруту, например «сделка — заказ — оплата». Так проще найти причину ошибки, чем при одновременном включении всех объектов.

Что записать в ТЗ на интеграцию

Формулировка «интеграция с 1С» в ТЗ не описывает работу: нужны объекты, поля, направление, частота и правила ошибок. Без этого оценка будет приблизительной, а приёмка спорной. Общая структура документа разобрана в чеклисте ТЗ, для интеграции добавьте:

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

Часто интеграция — лишь часть большей задачи. Если нужна связка продаж, склада и финансов, смотрите услугу ERP, CRM, HRM: в неё входят интеграции с 1С, AmoCRM, платёжными системами и внешними API. Если цель — быстро получать ответы по данным учёта, Company Brain подключается к 1С и CRM и отвечает со ссылками на источники.

С чего начать

Начните с короткой карты данных: какие объекты живут в 1С, какие в других системах и какая система главная для каждого из них. Одной таблицы на страницу достаточно для первой оценки.

Дальше порядок такой:

1. Выберите один маршрут с наибольшими ручными потерями.
2. Уточните конфигурацию 1С, версию и возможность её дорабатывать.
3. Подготовьте тестовую копию базы и примеры документов.
4. Запишитесь на 30-минутный созвон: разберём задачу, а коммерческое предложение W2W готовит за 2–3 дня.

Ставка команды W2W — $10–30 в час. Исходный код, архитектура и документация передаются клиенту. Шаблоны брифа, ТЗ, договора и NDA лежат в разделе «Документы».