Как грузоотправителю самостоятельно отменить проведенную ТТН в ЕГАИС через XML-запрос в УТМ?

В практике работы с алкогольной продукцией часто возникают ситуации, когда исходящая товарно-транспортная накладная (ТТН) уже получила в системе ЕГАИС статус «Проведена», но ее необходимо отозвать. Причины могут быть разными: ошибка в реквизитах, неверный состав продукции или невозможность связаться с грузополучателем для оформления акта отказа с его стороны. Если в вашей учетной программе (например, старой версии 1С или специализированном софте) отсутствует кнопка отмены проведения, задачу можно решить вручную через веб-интерфейс или прямую отправку XML-файла в Универсальный Транспортный Модуль (УТМ). Для ведения операций без ручной отправки файлов можно настроить автоматизированный обмен данными между 1С и ЕГАИС.

Разберем подробно, как сформировать и отправить такой запрос, чтобы вернуть товарные остатки на баланс организации-отправителя.

Понятие запроса на отмену проведения (RequestRepealWB)

Для начала проанализируем разницу в подходах. В системе ЕГАИС существует два способа «аннулировать» накладную со стороны поставщика:

1. Акт отказа (WayBillAct с типом Rejected): Поставщик может отправить его в ответ на входящую ТТН, либо в некоторых случаях попытаться отправить его как ответ на свою же накладную, если она еще не принята получателем.
2. Запрос на отмену проведения (RequestRepealWB): Это специализированный технический запрос (согласно документации УТМ версии 3.0 и выше), который инициирует процедуру отзыва документа. Именно этот метод является наиболее корректным для «распроведения» ошибочно отправленной накладной.

Важно помнить: если грузополучатель уже подтвердил вашу накладную, автоматической отмены не произойдет. В этом случае ЕГАИС сформирует «Запрос на подтверждение отмены», который должен будет подтвердить уже ваш контрагент в своем УТМ.

Шаг 1. Подготовка данных для XML-файла

Прежде чем приступать к редактированию файла, нам необходимо собрать обязательные реквизиты. Нам потребуются:

• FSRAR_ID отправителя (вашей организации).
• WBRegId — регистрационный номер накладной в системе ЕГАИС (вида TTN-0000000000).
• Текущая дата и время в формате гггг-мм-дчTчч:мм:сс.
• Внутренний номер запроса (любое уникальное число в рамках вашей системы).

Шаг 2. Формирование XML-файла для отмены ТТН

Рассмотрим структуру файла RequestRepealWB.xml. Это стандартный формат запроса, который понимает УТМ. Создайте текстовый файл, скопируйте туда приведенный ниже код и замените данные в тегах на свои значения.

<?xml version="1.0" encoding="UTF-8"?>
<ns:Documents xmlns:ns="http://fsrar.ru/WEGAIS/WB_DocID_v4" 
              xmlns:orep="http://fsrar.ru/WEGAIS/RequestRepealWB" 
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ns:Owner>
    <ns:FSRAR_ID>030000194005</ns:FSRAR_ID> <!-- Замените на ваш FSRAR_ID -->
  </ns:Owner>
  <ns:Document>
    <ns:RequestRepealWB>
      <orep:ClientId>030000194005</orep:ClientId> <!-- Снова ваш FSRAR_ID -->
      <orep:RequestNumber>1</orep:RequestNumber> <!-- Номер запроса, например 1 -->
      <orep:RequestDate>2023-10-27T12:00:00</orep:RequestDate> <!-- Текущее время -->
      <orep:WBRegId>TTN-0123456789</orep:WBRegId> <!-- Номер вашей ТТН -->
    </ns:RequestRepealWB>
  </ns:Document>
</ns:Documents>

В этом примере мы используем схему четвертой версии (v4). Если ваш УТМ работает на старых схемах, названия пространств имен могут отличаться, но для современных версий (4.x) данный шаблон является актуальным.

Шаг 3. Отправка запроса через УТМ

После того как файл подготовлен, его нужно передать на сервер ЕГАИС через ваш локальный УТМ. Сделать это можно несколькими способами.

Способ А: Использование веб-интерфейса УТМ

В современных версиях УТМ (начиная с 4.0 и выше) есть встроенная страница для отправки произвольных файлов. Рассмотрим этот процесс:

1. Откройте браузер и перейдите по адресу http://localhost:17777 (или другой порт, если вы его меняли).
2. Найдите раздел «Генерация запросов» или «Отправка документа».
3. Выберите созданный вами XML-файл и укажите тип документа (в данном случае это запрос на отмену ТТН).
4. Нажмите кнопку «Отправить».

Способ Б: Отправка через командную строку (cURL)

Если вы опытный пользователь или системный администратор, проще всего воспользоваться утилитой curl, которая встроена в Windows 10/11:

curl -F "xml_file=@C:\Egais\RequestRepealWB.xml" http://localhost:17777/opt/in/RequestRepealWB

Разберем параметры этой команды: -F указывает на передачу файла, за которым следует путь к вашему XML. Адрес /opt/in/RequestRepealWB — это «входящая очередь» УТМ специально для запросов на отмену проведения.

Шаг 4. Проверка результата

После отправки файла УТМ вернет ответ в виде XML, содержащий идентификатор запроса (ReplyId). Это означает, что документ принят в очередь на отправку. Выясним, прошла ли отмена успешно, проанализировав следующие источники:

1. Вкладка «Исходящие» в УТМ: Проверьте, ушел ли документ на сервер.
2. Вкладка «Входящие» в УТМ: Через несколько минут (обычно от 2 до 15) придет квитанция (Ticket). В ней должно быть указано: <tc:OperationResult>Accepted</tc:OperationResult>.
3. Сервис Check1: Перейдите на официальный портал check.fsrar.ru, введите номер вашей ТТН и ID отправителя. В истории документа должна появиться запись об отзыве накладной или о поступлении запроса на отмену проведения.

Почему остатки могут не вернуться сразу?

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

• Ожидание подтверждения от второй стороны: Если накладная уже была в статусе «Принята», ЕГАИС ждет согласия покупателя на распроведение. Пока он не нажмет «Подтвердить отмену» в своем ПО, остатки будут «зависать» в пути.
• Разные регистры: Проверьте, с какого регистра списывался товар. Если вы отправляли продукцию с Регистра 1 (склад), она должна вернуться туда же. Если же накладная была оформлена по Регистру 2 (торговый зал), проверяйте остатки на нем.
• Задержки сервера: В периоды высокой нагрузки (праздники, отчетные даты) время обработки транзакций в ЕГАИС может увеличиваться до нескольких часов.

Использование ручного формирования XML-запроса — это мощный инструмент, который позволяет выйти из «тупиковых» ситуаций, когда программное обеспечение не предоставляет нужного функционала. Главное — строго соблюдать структуру XML-схемы и корректно указывать идентификаторы документов. Чтобы упростить операции с алкогольной продукцией в учетной системе, можно использовать помощник для автоматизации работы с ЕГАИС в 1С.