Автоматизация алкогольного учёта: интеграция 1С-Битрикс с ЕГАИС

Интеграция 1С-Битрикс с ЕГАИС: настройка, кейсы и сроки

Ошибка списания алкоголя в ЕГАИС — одна из частых причин блокировки лицензии интернет-магазина. Каждая нефиксированная продажа грозит штрафом до $2.7k–3.9k. Мы специализируемся на интеграции 1С-Битрикс с ЕГАИС под ключ: автоматизируем передачу данных о продажах, возвратах и остатках. Гарантируем фиксацию каждой операции — исключаем штрафы. За время работы выполнили более 50 проектов для алкогольных интернет-магазинов.

ЕГАИС — федеральная система учёта алкоголя. Интернет-магазин, продающий алкоголь дистанционно, обязан фиксировать каждую продажу. 1С-Битрикс должен взаимодействовать с ЕГАИС через УТМ (универсальный транспортный модуль) — локальное ПО, которое шифрует и подписывает обращения к ЕГАИС.

Ручное списание алкоголя занимает до 2 часов в день и чревато ошибками. При зарплате оператора $9–13./ч это $540–780. ежемесячных дополнительных затрат. Автоматизация окупается за 1-2 месяца за счёт исключения штрафов и экономии времени.

Что такое УТМ и зачем он нужен?

УТМ — универсальный транспортный модуль, разработанный Росалкогольрегулированием. Это локальное Windows- или Linux-приложение, которое принимает XML-запросы от сайта, шифрует их с помощью криптоключа JaCarta и отправляет в ЕГАИС. Ответы УТМ получает асинхронно и помещает в очередь для загрузки. Без УТМ прямая интеграция с ЕГАИС невозможна.

Архитектура интеграции

ЕГАИС не предоставляет облачный REST API. Взаимодействие только через УТМ, установленный на локальном сервере. УТМ принимает XML-запросы на порту 8080 и отдаёт ответы через очередь.

1С-Битрикс → XML-запрос → УТМ (localhost:8080)
↓
ЕГАИС (Росалкогольрегулирование)
↓
УТМ формирует ответ → Битрикс polling очереди ответов

Схема асинхронная: запрос отправлен — ответ появляется через секунды или минуты.

Структура XML для запроса списания

<!-- TTNQuery — запрос на списание при реализации -->
<?xml version="1.0" encoding="utf-8"?>
<ns:Documents xmlns:ns="urn:TNInformF2Reg:Documents" xmlns:oref="urn:TNInformF2:OrgInfo" version="2">
  <ns:Document>
    <ns:TTNInformF2Reg>
      <ns:Header>
        <ns:IsSSMark>0</ns:IsSSMark>
      </ns:Header>
      <ns:Content>
        <ns:Position>
          <ns:Identity>1</ns:Identity>
          <ns:ProductCode>0366700000002375890</ns:ProductCode>
          <ns:Quantity>1.000</ns:Quantity>
          <ns:InformF1RegId>TEST-TTN123456</ns:InformF1RegId>
          <ns:InformF2RegId>TEST-F2-123456</ns:InformF2RegId>
        </ns:Position>
      </ns:Content>
    </ns:TTNInformF2Reg>
  </ns:Document>
</ns:Documents>

PHP-клиент для взаимодействия с УТМ

class EgaisUtmClient {
    private string $utmUrl;
    private string $orgRarId; // идентификатор организации в ЕГАИС

    public function __construct(string $utmUrl, string $orgRarId) {
        $this->utmUrl = $utmUrl; // http://localhost:8080
        $this->orgRarId = $orgRarId;
    }

    public function sendDocument(string $xmlDocument): string {
        $response = file_get_contents(
            $this->utmUrl . '/opt/in/TTNInformF2Reg',
            false,
            stream_context_create([
                'http' => [
                    'method' => 'POST',
                    'header' => 'Content-Type: application/xml',
                    'content' => $xmlDocument,
                ]
            ])
        );
        $replyXml = simplexml_load_string($response);
        return (string)$replyXml->ReplyId;
    }

    public function getReplyQueue(): array {
        $response = file_get_contents($this->utmUrl . '/opt/out');
        return $this->parseQueue($response);
    }

    public function getReply(string $replyId): ?array {
        $response = file_get_contents(
            $this->utmUrl . "/opt/out/TTNInformF2Reg/{$replyId}"
        );
        if (!$response) return null;
        $xml = simplexml_load_string($response);
        return [
            'result' => (string)$xml->Result->Conclusion,
            'comment' => (string)$xml->Result->ConclusionDate,
            'egais_id' => (string)$xml->Result->AccisesHeader->EGAISQuntId,
        ];
    }
}

Обработка заказов в Битрикс

// Обработчик события смены статуса заказа
\Bitrix\Main\EventManager::getInstance()->addEventHandler(
    'sale',
    'OnSaleStatusOrderChange',
    function (\Bitrix\Main\Event $event) {
        $order = $event->getParameter('ENTITY');
        $statusId = $event->getParameter('VALUE');
        if ($statusId !== 'shipped') return; // отправка только при статусе «Отгружен»
        $egaisItems = $this->getAlcoholItemsFromOrder($order);
        if (empty($egaisItems)) return;
        $client = new EgaisUtmClient(EGAIS_UTM_URL, EGAIS_ORG_RAR_ID);
        $xml = $this->buildActWriteOff($order, $egaisItems);
        $replyId = $client->sendDocument($xml);
        // Сохраняем replyId для отслеживания
        EgaisDocumentTable::add([
            'ORDER_ID' => $order->getId(),
            'REPLY_ID' => $replyId,
            'STATUS' => 'pending',
            'SENT_AT' => new \Bitrix\Main\Type\DateTime(),
        ]);
    }
);

Как избежать ошибок при обмене с ЕГАИС? Кейс из нашей практики

Из нашей практики: онлайн-магазин вино-водочных изделий, ~300 заказов в день. Ежедневная задача — списание каждой реализованной единицы алкоголя в ЕГАИС. При ошибке списания заказ нельзя считать закрытым с точки зрения закона.

Проблемы проекта:

1. УТМ установлен на офисном Windows-компьютере, сайт — на хостинге. Прямого сетевого доступа нет.

2. Иногда УТМ не отвечал (перезагрузки, обновления), документы терялись.

3. ЕГАИС возвращает AlcoCode — уникальный код каждой бутылки (для маркированного алкоголя), нужно хранить соответствие AlcoCode ↔ позиция заказа.

Решения:

1. VPN-туннель между хостингом и офисным сервером + Middleware на офисном сервере, который принимает запросы из Битрикс и передаёт в УТМ. Middleware на Node.js, работает как Windows-служба.

2. Очередь задач на стороне Битрикс: неподтверждённые документы переотправляются через 10 минут (до 5 попыток). При исчерпании — уведомление администратору.

3. При получении подтверждения от ЕГАИС — сохраняем EGAISQuntId в таблице local_egais_alcocodes, связь с позицией заказа Битрикс.

Автоматическая интеграция в 10 раз быстрее ручного ввода данных и исключает штрафы до $2.7k–3.9k. за каждое нефиксированное списание.

Возвраты в ЕГАИС

При возврате алкоголя — обратная операция: постановка на баланс через документ WayBillAct. Триггер — событие возврата в Битрикс (OnSaleRefund).

Остатки ЕГАИС в Битрикс

Для синхронизации остатков на складе с данными ЕГАИС — периодический запрос к УТМ (RestBal) и сравнение с остатками в каталоге Битрикс. Расхождения — в лог для ревизии.

Что входит в работу

• Настройка УТМ, получение ключей ЕГАИС (через Росалкогольрегулирование)
• Сетевая связка: VPN или Middleware-сервис
• PHP-клиент для УТМ: отправка документов, polling ответов
• Генерация XML для актов списания, возвратов
• Обработчики событий Битрикс: отгрузка, возврат
• Очередь с ретраями, мониторинг ошибок
• Таблица истории ЕГАИС-документов в Битрикс
• Обучение администратора, 3 месяца поддержки

Сравнение ручного и автоматического подхода:

Типичные ошибки при настройке:

• Отсутствие постоянного сетевого канала к УТМ — документы не доходят.
• Неправильные сертификаты — ЕГАИС отклоняет запросы.
• Пропуск статусов заказа — списание не триггерится.
• Нет обработки очереди ответов — подтверждения теряются.

Почему стоит доверить интеграцию нашим инженерам?

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

Сроки: при наличии настроенного УТМ и сетевого доступа — 4–6 недель. При необходимости настройки инфраструктуры — 8–12 недель. Стоимость рассчитывается индивидуально. Получите консультацию инженера уже сегодня.