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

Технически интеграция работает с любой современной конфигурацией 1С 8.3 — это 1С:Бухгалтерия 3.0, 1С:ERP 2, 1С:Комплексная автоматизация 2, 1С:Управление торговлей 11, 1С:Управление нашей фирмой и другие. Сверка по документам реализации, поступления и чеков ККМ — типовые документы, присутствуют в большинстве торговых конфигураций. По умолчанию настройки заточены под 1С:УНФ — для других конфигураций адрес подключения меняется в настройках обмена по юрлицу. Самописные и сильно доработанные конфигурации подключаются через настраиваемые шаблоны обмена, без обновления самой ERP.

Сегодня — закрывающие документы (УПД продажи и закупки) и справочник номенклатуры. УПД формируется со всеми реквизитами организации, контрагента, склада и табличной частью с товарами. Номенклатура передаётся вместе с иерархией категорий, штрихкодами, единицами измерения. Чеки ККМ уходят отдельной цепочкой через канал сверки 1С. Расширение на другие типы документов (платежи, инвентаризации, перемещения) — это добавление нового модуля передачи за одну-две недели по требованиям клиента.

ERP сначала пробует отправить документ напрямую. Если соединение упало по таймауту, вернулась ошибка авторизации или внутренняя ошибка сервера — автоматически срабатывает резервный канал: документ кладётся файлом в согласованную папку обмена. 1С штатным механизмом сама подхватит файл из этой папки и проведёт документ. В журнале обе попытки видны как отдельные строки — первая «не удалось напрямую», вторая «успешно через файловый обмен», бизнес-процесс не страдает.

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

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

Три способа: логин и пароль (стандартный для большинства локальных установок 1С), токен (для облачных 1С с современной авторизацией) или открытый доступ (если 1С и ERP находятся в одной защищённой внутренней сети). Дополнительно можно проставить любые свои заголовки — например, чтобы 1С могла отличить сообщения от ERP, или для дополнительной проверки на стороне 1С. Срок ожидания ответа — две минуты по умолчанию, защищает от зависших соединений.

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

Система автоматически повторяет отправку до пяти раз с задержкой в одну минуту между попытками. Если после пяти неудач документ всё ещё не выгружен, он помечается как «требует синхронизации» и снова попадёт в очередь при следующей массовой выгрузке. Параллельно ответственные сотрудники (администратор, бухгалтер, менеджер) получают уведомление о сбое через выбранные ими каналы — Telegram, email или push в браузер. Между повторными уведомлениями по одному и тому же документу выдерживается пауза в четыре часа, чтобы не было дубликатов.

Да. На карточке документа есть кнопка «Просмотр сообщения для 1С» — она показывает готовое сообщение в том виде, в котором оно уйдёт. Используется индивидуальный шаблон обмена, если он задан, или встроенный формат. При первом подключении нового юрлица интегратор смотрит, что именно уйдёт, и при необходимости поправит мастер-данные — ИНН и КПП организации, коды товаров в 1С. Аналогично перед выгрузкой большого справочника номенклатуры можно заранее посчитать, сколько позиций уйдёт, и оценить нагрузку.

Используется принятый в 1С 8.3 стандарт обмена. Сообщение состоит из заголовка (формат, дата создания, версия) и тела с конкретным документом. Внутри документа реквизиты идут в строго определённом порядке: сначала ключевые свойства (ссылка, дата, номер), затем организация, контрагент, склад, валюта и табличная часть с товарами. Для единиц измерения используются официальные коды ОКЕИ — штуки, метры, килограммы, литры — это требование ФНС. Все спецсимволы корректно экранируются, кодировка UTF-8 — 1С принимает сообщение «как есть» и не отбрасывает по формальным причинам.

Сегодня два встроенных обработчика. Первый — сверка проведения приходных накладных: разбирает XLSX от 1С со столбцами «идентификатор документа», «проведён», «дата», находит документ закупки в ERP и обновляет его статус проведения. Второй — то же самое для документов продажи. Дополнительно идёт обратная сверка: документы ERP, которых нет в файле от 1С, попадают в отдельный список — это значит, что они либо не выгружены в 1С, либо отменены. Для таких документов можно одним кликом сбросить отметку «выгружен», и при следующей передаче они уйдут заново.

Архитектура расширяемая. Новый обработчик — это отдельный модуль, который понимает структуру конкретного типа файла и знает, что с ним сделать в ERP. У каждого обработчика есть описание обязательных полей — система использует его, чтобы в админке показать сотруднику «вот колонки из вашего файла, сопоставьте их с целевыми». Сегодня встроены обработчики для сверки проведения накладных; добавление импорта справочников (товары, контрагенты, цены) — это одна-две недели работы под требования конкретного клиента.

У каждого импорта своё расписание — задаётся прямо в его карточке. Можно поставить «каждые 5 минут» для оперативной сверки, «каждый час», «в час ночи ежедневно», «по будням в 8 утра» — любое регулярное правило. Каждую минуту система проверяет, какие импорты пора запускать, и ставит их в очередь обработки. Один запуск может длиться до десяти минут — этого хватает даже для больших файлов. Если расписание не задано — импорт работает только по ручному запуску из админки.

Да. Для каждого юрлица в холдинге заводится своя отдельная карточка настроек обмена с 1С. У каждого юрлица — свои реквизиты подключения и свой срок ожидания ответа. Одна команда «выгрузить справочник» проходит по всем юрлицам с готовыми настройками и отправляет данные в каждую базу 1С отдельно. Холдинг с шестью юрлицами и шестью разными базами 1С — это шесть карточек настроек, шесть журналов отправок (по одному на каждое юрлицо). Настройки никак не пересекаются между собой.

Сегодня поддерживается актуальная версия стандарта обмена 1С 8.3 — она работает с 1С:Управление торговлей 11.5 и старше, 1С:Комплексной автоматизацией 2.5 и старше, 1С:ERP 2.5 и старше, 1С:Бухгалтерией 3.0 и 1С:Управление нашей фирмой. Для старых конфигураций (1С:Бухгалтерия 2.0, 1С:Управление торговлей 10.3) с более ранними версиями стандарта поддержка реализуется по запросу — это расширение существующего модуля передачи.

В ERP встроена таблица из примерно 25 единиц измерения с официальными кодами ОКЕИ: штуки, метры, килограммы, литры, тонны, кубические метры, квадратные метры, упаковки, изделия и другие. По названию единицы система сама подбирает правильный код. Это важно: ФНС требует наличие кодов ОКЕИ в УПД, без них 1С откажет в проведении и налоговая не примет декларацию. Если единица в товаре не распознана, по умолчанию подставляются штуки — самый частый случай.

Это не разовый ручной импорт XLSX, а полноценная миграция. ERP может за один проход выгрузить весь справочник активных товаров в 1С (для тех, кто наоборот переезжает с 1С на нас, есть обратный сценарий через приём файлов от 1С). Настраиваемые шаблоны позволяют адаптировать формат под особенности базы клиента. Журнал отправок даёт полный аудит первой выгрузки — что прошло, что не прошло, что нужно поправить. Обычно миграция занимает 2–4 недели: справочники в первую неделю, тестовый прогон документов во вторую, окончательное переключение в третью.

В карточке настроек обмена для каждого юрлица есть кнопка «Проверить связь» — система отдельно проверяет оба способа передачи: прямое соединение и файловый обмен. Результат показывается рядом: «прямое соединение — работает», «файловая папка — работает», или с описанием ошибки. Аналогично есть отдельная кнопка для проверки канала сверки. Если возвращается ошибка авторизации — сразу видно, что реквизиты неверные, и можно поправить, не дожидаясь первой реальной попытки отправки документа.

Да. Все обращения к 1С и от 1С пишутся в три отдельных журнала: журнал отправок документов, журнал сверок и журнал приёма файлов. Файловые журналы хранятся 30 дней. Параллельно в базе данных хранятся подробные журналы по каждому документу (с полным текстом отправленного сообщения и ответом 1С) и по каждому запуску импорта (со сводной статистикой: сколько обработано, обновлено, не найдено). Эти два источника вместе дают полную картину обмена и помогают разобрать любой инцидент за минуты, а не за часы.

Номер таможенной декларации и признак прослеживаемости товара (по статье 169 Налогового кодекса) указываются на уровне строки документа и автоматически уходят в 1С в составе табличной части документа поступления — в реквизиты счёта-фактуры. Это значит, что импортный товар с заполненными полями корректно отражается в 1С:Бухгалтерии и проходит без замечаний при отчётности перед ФНС по системе прослеживаемости.

Больше 20. Управление настройками обмена по юрлицам (просмотр, изменение, проверка связи отдельно по каждому способу передачи, выгрузка справочника на одну организацию или сразу на все). Управление импортами (создание, изменение, удаление, ручной запуск, история запусков, сброс статусов, предпросмотр колонок файла). Работа с документами (массовая выгрузка в 1С, статус синхронизации, журнал отправок, предпросмотр сообщения, отправка по одному, отправка через канал сверки). Отдельная цепочка для чеков ККМ. Сверка документов с 1С со списком расхождений.

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

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

Это типовой сценарий. Бухгалтерский и налоговый учёт остаются в 1С:Бухгалтерии — AIERP не дублирует эти функции. Из ERP в 1С автоматически уходят закрывающие документы (УПД продажи и закупки) и чеки ККМ — бухгалтеру не нужно ничего переносить руками. Внедрение идёт по модулям: сначала самый «болевой» (управление заказами, ценообразование, интернет-магазин), затем касса, склад, мотивация, выездная логистика. Средний срок полного развёртывания — 3 месяца, но первые модули запускаются в работу уже через 3–4 недели после старта проекта.