Интеграция с 1С
EAMForge связывается с 1С:Бухгалтерия предприятия 3.0: складские операции, выполненные в EAMForge (приходы, выдачи, списания, перемещения, заявки на закупку), автоматически превращаются в документы 1С, а справочники (номенклатура, контрагенты, сотрудники, склады) подтягиваются из 1С. Бухгалтеру не нужно вводить первичку вручную — он только проверяет и проводит готовые документы.
Коротко: как устроено
Связь работает по pull-модели: EAMForge не «стучится» в 1С напрямую. Вместо этого специальная обработка EAMForge_Sync.epf, установленная в 1С, сама раз в ~5 минут забирает накопленные события из EAMForge и создаёт документы у себя.
- В EAMForge происходит операция (например, кладовщик выдал материал).
- Событие попадает в очередь на отправку в 1С.
- Обработка в 1С по расписанию забирает очередь и создаёт документ.
- 1С подтверждает создание — событие помечается «Создано в 1С».
- Повтор того же события защищён от дублей (идемпотентность).
ℹ️К сведению
Почему именно так: 1С у клиента обычно стоит за фаерволом/NAT, и «снаружи» к ней не достучаться. Pull-модель работает в любой сети — нужен только исходящий доступ из 1С к адресу EAMForge.
Что синхронизируется
Делаете в EAMForge → ищете в 1С — операции становятся документами 1С:
| Действие в EAMForge | Документ в 1С | Где в 1С |
|---|---|---|
| Приход на склад | Поступление товаров и услуг | Покупки → Поступления |
| Выдача со склада (обычная) | Требование-накладная («Расход материалов») | Склад → Расход материалов |
| Выдать со списанием | Требование-накладная («Расход материалов») | Склад → Расход материалов |
| Выдача сотруднику в эксплуатацию (инвентарь/инструмент) | Передача материалов в эксплуатацию (МЦ.04) | Склад → Передача материалов в эксплуатацию |
| Списание со склада (товары) | Списание товаров | Склад → Списание (недостачи) |
| Списание из эксплуатации (инвентарь) | Списание материалов из эксплуатации | Склад → Списание материалов из эксплуатации |
| Возврат на склад (товары) | Оприходование товаров | Склад → Оприходование товаров |
| Возврат из эксплуатации | Возврат материалов из эксплуатации | Склад → Возврат материалов из эксплуатации |
| Выдача материалов в заявку на ремонт | Требование-накладная | Склад → Расход материалов |
| Списание основного средства | Списание ОС | ОС и НМА → Списание ОС |
| Перемещение между складами | Перемещение товаров | Склад → Перемещение товаров |
| Заявка на закупку (отправлена) | Счёт на оплату поставщика | Покупки → Счета поставщикам |
ℹ️К сведению
Каким документом обернётся выдача/списание/возврат, решает учётная категория позиции:на балансе (товары/материалы) → Расход / Списание / Оприходование товаров;в эксплуатации (инвентарь/инструмент, выдан сотруднику под отчёт) → документы забаланса МЦ.04.
Делаете в 1С → появляется в EAMForge — подтягиваются только справочники, кнопками в обработке:
| Действие в 1С | Кнопка в обработке | Что появляется в EAMForge |
|---|---|---|
| Завели / изменили Номенклатуру | Синхронизировать номенклатуру | Шаблон ТМЦ (+ себестоимость как цена закупки) |
| Завели Контрагента | Синхронизировать контрагентов | Контрагент (по БИН/ИНН) |
| Завели Физлицо / сотрудника | Синхронизировать физлица | Сотрудник / МОЛ (по ИИН) |
| Склады | Синхронизировать склады | Связь склада EAMForge ↔ 1С |
⚠️Важно
Документы 1С в EAMForge не переносятся — поток документов идёт только EAMForge → 1С. Если оприходовать ТМЦ в 1С, EAMForge этот остатокне увидит (карточку номенклатуры подтянуть можно, но без количества). Поэтому приходы и движения склада делайте в EAMForge — оттуда они уйдут в 1С.
ℹ️К сведению
Проводки, счета учёта, закрытие месяца, НДС, себестоимость, зарплата — остаются целиком в зоне 1С. EAMForge создаёт только первичные документы движения; всё остальное бухгалтер ведёт в 1С как обычно. 1С остаётся единственным источником истины по деньгам.
Кто что делает
| Роль | Где работает | Что делает |
|---|---|---|
| Администратор EAMForge | EAMForge → Админ → Интеграция с 1С | Выдаёт токен, следит за состоянием, разбирает «Внимание» |
| Бухгалтер / 1С-специалист | 1С → обработка EAMForge_Sync | Синхронизирует документы и справочники, проводит документы |
Настройка (один раз)
Шаг 1. В EAMForge — администратор
- Откройте Админ → Интеграция с 1С (
/admin/integrations/onec). - Вкладка «Настройки» → создайте API-токен для 1С.
- Скопируйте токен сразу — он показывается один раз.
- Передайте бухгалтеру адрес API и токен.
⚠️Важно
Токен показывается только один раз при создании — скопируйте его сразу. Потом он нигде не отображается: можно лишь отозвать и создать новый. Хранится в зашифрованном виде, отдельный для каждой организации.
Шаг 2. В 1С — бухгалтер / 1С-специалист
- Получите от администратора EAMForge адрес API и токен.
- Скачайте обработку
EAMForge_Sync.epf. - В 1С: Файл → Открыть → выберите файл
.epf(на предупреждение безопасности нажмите «Да» — это нормально). - На форме впишите адрес и токен → нажмите «Тест соединения». Должно появиться «✅ Подключено к: ваша организация».
- Заполните значения по умолчанию (склад, статья затрат, способ отражения расходов, контрагент-поставщик) — они подставляются, если в событии нет явного значения.
- Подключите обработку как «Дополнительную обработку» с регламентным заданием (раз в 5 минут) — тогда синхронизация идёт автоматически.
💡Совет
Перед первым обменом документами нажмите кнопки синхронизации справочников («Номенклатура», «Контрагенты», «Физлица», «Склады») — так объекты EAMForge и 1С свяжутся заранее, и документы будут создаваться без ручного сопоставления.
Постоянная установка — чтобы не открывать файл каждый раз
Чтобы не загружать .epf через «Файл → Открыть» при каждом запуске, добавьте обработку в саму базу 1С как дополнительную:
- Администрирование → Печатные формы, отчёты и обработки → включите флажок «Дополнительные отчёты и обработки».
- Откройте список «Дополнительные отчёты и обработки» → Создать → Загрузить из файла → выберите
EAMForge_Sync.epf. - Укажите раздел размещения и, при необходимости, быстрый доступ нужным пользователям — обработка появится прямо в их меню (раздел «Сервис» / «Дополнительные обработки»).
- Для автоматической работы задайте расписание регламентного задания (напр. раз в 5 минут) — «Синхронизировать документы» будет выполняться само, без участия человека.
⚠️Важно
В файловой базе 1С регламентные задания по расписанию сами не запускаются — нужен либо постоянно открытый сеанс, либо запуск синхронизации вручную кнопкой. Вклиент-серверной базе расписание работает автоматически.
ℹ️К сведению
Настройки сохраняются в самой базе 1С (в хранилище общих настроек), а не в файле обработки. Нажмите «Сохранить настройки» один раз — адрес, токен и значения по умолчанию не потеряются при переоткрытии и не зависят от того, запускаете вы обработку из файла или из меню.
Работа в EAMForge: страница «Интеграция с 1С»
В админке (/admin/integrations/onec) наверху всегда виден вердикт: 🟢 «Интеграция работает — всё синхронизировано», либо 🟡 «N документов требуют внимания» с кнопкой «Разобрать». Ниже — четыре вкладки:
- Состояние — сводка (создано в 1С, в очереди, требуют внимания, сопоставлений) и блок «Как это работает».
- Журнал — история всех событий с понятными статусами (В очереди, Создано в 1С, Требует внимания…), с фильтром и поиском.
- Внимание — документы, которые 1С не смогла создать автоматически; по каждому написано, что случилось и что сделать.
- Настройки — токены доступа и сопоставления (связи «объект EAMForge ↔ объект 1С»).
ℹ️К сведению
Статусы документа: В очереди — ждёт, пока 1С заберёт; Создано в 1С — документ сформирован; Требует внимания — нужно вмешательство;Отменено — снято вручную.
Работа в 1С: обработка EAMForge_Sync
На форме обработки есть кнопки:
| Кнопка | Что делает |
|---|---|
| Тест соединения | Проверяет адрес и токен; показывает, сколько в EAMForge документов «требуют внимания». |
| Синхронизировать документы | Забирает очередь событий и создаёт документы в 1С. Показывает итог: обработано / требуют внимания / ошибок. |
| Синхронизировать номенклатуру | Подтягивает справочник номенклатуры (и себестоимость) в EAMForge. |
| Синхронизировать контрагентов | Подтягивает контрагентов (сопоставление по БИН/ИНН). |
| Синхронизировать физлица | Подтягивает сотрудников (сопоставление по ИИН). |
| Синхронизировать склады | Связывает склады EAMForge со складами 1С. |
При настроенном регламентном задании «Синхронизировать документы» выполняется автоматически — кнопки нужны для разовой/ручной синхронизации и для справочников.
Настройки на форме обработки
Заполняются один раз; подставляются в документы, если в самом событии нет явного значения:
| Поле | Что задаёт |
|---|---|
| Адрес (URL) и Токен | Адрес EAMForge API и ключ доступа. |
| Организация по умолчанию | От имени какой организации создаются документы. |
| Склад по умолчанию | Склад, если в событии он не указан. |
| Подразделение по умолчанию | Подразделение для документов. |
| Статья затрат / Счёт затрат по умолчанию | Куда относить расходы при выдаче в эксплуатацию и списании. |
| Контрагент-поставщик по умолчанию | Поставщик, если он не определён по событию. |
| Режим записи документа | Выпадающий список (выбор значения — печатать вручную не нужно). Провести — по умолчанию: создать документ и провести; если провести не удалось — документ остаётся черновиком, а в EAMForge появляется пометка «не проведено» с причиной (см. заметку ниже). Записать (черновик, без проводок) — создавать черновики и проводить вручную после проверки. Провести и закрыть — то же, что «Провести». |
| Источник серии | Для серийных (поэкземплярных) позиций — откуда брать номер серии: Серийный номер, RFID-метка (EPC) или Шаблон. |
| Автосоздание номенклатуры (+ группа) | Создавать недостающую номенклатуру автоматически в указанной группе. |
| Авто-включать серийный учёт | Включать серии у номенклатуры, если они не были включены. |
| Период регламента, мин | Как часто запускается авто-синхронизация документов. |
| Sandbox-режим | Тестовый режим (для проверки без реального эффекта). |
ℹ️К сведению
Проведение и статус «не проведено». Обработка сначала создаёт черновик, затем проводит его отдельным шагом — поэтому неудача проведения никогда не теряет документ. Если провести не удалось — обычно это учётная политика клиента (не заполнены счета / способ отражения расходов), а не баг обработки — документ остаётся черновиком, а EAMForge помечает его «не проведено» с текстом ошибки 1С. Это честный статус вместо обманчивого «создано»: бухгалтер дозаполняет недостающее и проводит вручную. Защита от двойной отправки (fencing-токен) не даёт создать дубль документа при повторах.
Что показывают счётчики итога
После синхронизации документов:
- Получено — сколько событий забрано из очереди EAMForge.
- Обработано — сколько документов успешно создано в 1С.
- Ревью (требуют внимания) — 1С не смогла создать автоматически; эти документы ждут вас во вкладке «Внимание» в EAMForge.
- Ошибок — технических сбоев при обработке.
После синхронизации справочника (номенклатура/контрагенты/физлица/склады):
- Позиций — сколько записей справочника выгружено в EAMForge.
- Пачек — выгрузка идёт порциями (по 500 записей для скорости); сколько порций отправлено.
- Ошибок — сколько порций не удалось отправить.
ℹ️К сведению
Например, «Всего позиций: 10, отправлено пачек: 1, ошибок: 0» = выгружено 10 позиций одной порцией без ошибок. А «Обработано 5, ревью 1, ошибок 0» = создано 5 документов, ещё 1 ждёт разбора во «Внимание».
Сопоставление справочников
Чтобы документы создавались правильно, объекты EAMForge и 1С нужно «связать» (сопоставить). Связь создаётся автоматически при первой успешной обработке и запоминается — второй раз сопоставлять не нужно. Логика поиска пары (каскад):
- Номенклатура — по коду/артикулу, затем по названию.
- Контрагенты — по БИН/ИНН, затем по названию.
- Сотрудники (физлица) — по ИИН, затем по ФИО.
- Склады — по совпадению названия.
💡Совет
Самый надёжный ключ — это код/ИНН/ИИН, а не название. Если заполнить БИН у контрагентов и ИИН у сотрудников (и в EAMForge, и в 1С), сопоставление будет точным и не «поедет» из-за разного написания имён. Адресное хранение (стеллажи, ячейки) остаётся в EAMForge: в 1С уходит только склад-родитель.
Все сопоставления видны на вкладке Настройки → Сопоставления — там же их можно удалить (при следующем событии связь восстановится автоматически по каскаду).
Если документ «Требует внимания» — что делать
Когда 1С не может создать документ автоматически, он попадает во вкладку «Внимание»с объяснением. Исправьте причину и нажмите «Я исправил — повторить» (или«Не нужно», если документ не нужен). Частые причины:
| Причина | Что сделать |
|---|---|
| Поставщик не найден в 1С | Создайте контрагента в 1С (или «Синхронизировать контрагентов») → «Повторить». |
| Товар не сопоставлен с номенклатурой | Включите автосоздание номенклатуры или «Синхронизировать номенклатуру» → «Повторить». |
| Сотрудник (МОЛ) не сопоставлен | «Синхронизировать физлица» или задайте ИИН сотруднику → «Повторить». |
| Склад не сопоставлен | «Синхронизировать склады» (название склада должно совпадать) → «Повторить». |
| Нет партии в эксплуатации (МЦ.04) | Проверьте, что «Передача в эксплуатацию» по сотруднику проведена → «Повторить». |
| Ошибка при обработке в 1С | Прочитайте текст ошибки; обычно не заполнены счёт/реквизиты в 1С — поправьте → «Повторить». |
ℹ️К сведению
То же объяснение «что сделать» показывается прямо в карточке документа на вкладке «Внимание» — гадать не нужно. Счётчик «требуют внимания» гаснет сам, когда каждый документ либо повторно создан, либо отменён.
Требования и ограничения
| Тема | Что важно знать |
|---|---|
| Версия платформы 1С | Протестировано на 8.3.27. Для HTTP + JSON + OpenSSL нужна современная 8.3 — рекомендуем 8.3.15 и выше. |
| Базовая 1С = один пользователь | 1С:Бухгалтерия Базовая допускает только одну сессию одновременно. Пока регламент пишет/проводит документы, другой пользователь может на секунды получить «база заблокирована». Если мешает — поставьте синхронизацию на нерабочее время или увеличьте интервал. |
| Единицы измерения | Сопоставляются по строке имени — «шт» и «шт.» не свяжутся и могут создать дубль единицы. Приведите сокращения ЕИ к единому виду в обеих системах до включения синхронизации. |
| Возвраты | Возврат складским документом в 1С уходит (Возврат из эксплуатации / Оприходование). Возврат материала в рамках заявки (по факту использования) автоматически не отражается — оформите в 1С вручную. |
| Глубина истории | Обработанные события очереди хранятся ~90 дней, затем авто-очистка; кэш дедупа батчей — 7 дней. На уже созданные в 1С документы это не влияет, только на глубину просмотра журнала очереди. |
ℹ️К сведению
Почему документ не проводится. Для проведения нужно, чтобы позиция уже была на остатке (сделайте приход в 1С до выдачи) и были заполнены счета учёта / способ отражения расходов. Типовые ошибки — «не заполнены оба счёта» или «нет остатка на сч.10» — это настройка учёта на стороне 1С, а не баг обработки.
Безопасность
- Токены отдельные для каждой организации, хранятся в зашифрованном виде, показываются один раз.
- 1С обращается к EAMForge только на чтение очереди и подтверждение — прямого доступа к базе нет.
- Все действия (создание/отзыв токенов, изменение настроек, повтор/отмена событий) пишутся в журнал аудита.
- Токен можно отозвать в любой момент — связь сразу прекращается.