Система ЕГАИС (Единая государственная автоматизированная информационная система) предоставляет широкий набор сервисов для работы с алкогольной продукцией․ Чтобы получить нужную информацию от поставщиков или из внутренних регистров, пользователи формируют запросы в соответствии с определённым шаблоном․ Ниже подробно рассмотрены основные элементы такого шаблона, типы запросов и практические примеры их составления в программе Sh4Decl․exe․
Что такое шаблон запроса ЕГАИС
Шаблон запроса – это набор обязательных и необязательных полей, которые необходимо заполнить перед отправкой сообщения в ЕГАИС․ Заполнив шаблон корректно, пользователь получает ответ в виде справочника, накладной, справки или остатков, в зависимости от выбранного типа операции․
Основные преимущества использования шаблона:
- Единый формат обмена данными с ЕГАИС;
- Минимизация ошибок при вводе параметров;
- Возможность автоматизации повторных запросов (например, повторный запрос накладных)․
Основные элементы шаблона запроса
Независимо от типа запроса, в шаблоне присутствуют следующие группы полей:
Идентификация корреспондента - ИНН корреспондента – обязательное поле, по которому система ищет информацию о контрагенте;
- Код ЕГАИС корреспондента – альтернативный идентификатор, используемый при работе со справочниками;
Параметры запроса - Тип операции – определяет, какой именно сервис ЕГАИС будет задействован (товары АП, корреспонденты, накладные и т․д․);
- Период (опционально) – для запросов, связанных с движением продукции (например, остатки за определённый месяц);
- Идентификатор документа – ID накладной, справки или акта, если запрос направлен на конкретный документ;
- Алккод – код алкогольной продукции, необходимый для запросов по движению между регистрами или остаткам штрихкодов;
Дополнительные настройки - Формат ответа – XML, JSON или табличный вид (в зависимости от версии Sh4Decl․exe);
- Флаг повторного запроса – используется для функции «Повторный запрос накладных»;
- Указание причин списания – обязателен для актов списания (регистр 1 или регистр 2)․
Типы запросов и их шаблоны
- Тип операции – определяет, какой именно сервис ЕГАИС будет задействован (товары АП, корреспонденты, накладные и т․д․);
- Период (опционально) – для запросов, связанных с движением продукции (например, остатки за определённый месяц);
- Идентификатор документа – ID накладной, справки или акта, если запрос направлен на конкретный документ;
- Алккод – код алкогольной продукции, необходимый для запросов по движению между регистрами или остаткам штрихкодов;
Дополнительные настройки - Формат ответа – XML, JSON или табличный вид (в зависимости от версии Sh4Decl․exe);
- Флаг повторного запроса – используется для функции «Повторный запрос накладных»;
- Указание причин списания – обязателен для актов списания (регистр 1 или регистр 2)․
Типы запросов и их шаблоны
В зависимости от выбранного типа операции меняется набор обязательных полей․ Ниже приведены наиболее часто используемые запросы и примеры их заполнения․
Запрос товаров АП (Товары АП)
Получает список алкогольной продукции, с которой работает корреспондент․
- ИНН корреспондента – ###;
- Тип операции – Товары АП;
- (Опционально) Код ЕГАИС товара – если нужен фильтр по конкретному алкоду․
Пример заполнения (в виде текста, который вводится в форму Sh4Decl․exe):
ИНН: ###
Тип: Товары АП
Код ЕГАИС товара: (не заполняеться)
Запрос корреспондентов
Возвращает список подразделений контрагента по его ИНН․
- ИНН корреспондента – ###;
- Тип операции – Корреспонденты;
Пример:
ИНН: ###
Тип: Корреспонденты
Повторный запрос накладных (для УТМ 2․0․3)
Позволяет получить все неподтверждённые накладные, ранее удалённые из базы УТМ․
- ИНН корреспондента – ###;
- Тип операции – Повторный запрос накладных;
- Флаг повторного запроса – Включён;
- Период – – (опционально)․
Пример:
ИНН: ###
Тип: Повторный запрос накладных
Повторный запрос: Да
Период: ‑
Запрос накладной по ID
Запрашивает конкретную накладную (подтверждённую или нет) по её идентификатору․
- ИНН корреспондента – ###;
- Тип операции – Запрос накладной по ID;
- ID накладной – 20260910001234;
Пример:
ИНН: ###
Тип: Запрос накладной по ID
ID накладной: 20260910001234
Движение между регистрами
Получает историю перемещения алкогольной продукции между регистрами по алкоду․
- Алкод продукции – 01000123456789;
- Тип операции – Движение между регистрами;
- Период – – (опционально)․
Пример:
Алкод: 01000123456789
Тип: Движение между регистрами
Период: ‑
Справки Б и Справки А
Справка Б – подробная информация о конкретной поставке; Справка А – сопроводительная документация (например, для импортера)․
- ИНН корреспондента – ###;
- Тип операции – Справка Б (или Справка А);
- Номер справки – Б‑202609‑00123 (или А‑202609‑00456)․
Пример для справки Б:
ИНН: ###
Тип: Справка Б
Номер справки: Б‑202609‑00123
Остатки (регистр 1) и остатки в зале (регистр 2)
Запрос остатков позволяет формировать акты постановки на баланс, передачи в торговый зал и списания․
- ИНН корреспондента – ###;
- Тип операции – Остатки (регистр 1) (или Остатки в зале (регистр 2));
- Дата остатка – (опционально)․
Пример остатков на первом регистре:
ИНН: ###
Тип: Остатки (регистр 1)
Акт постановки на баланс (регистр 1) и связанные акты
Для оформления акта необходимо указать причину и, при необходимости, данные из справок А и Б․
- ИНН корреспондента – ###;
- Тип операции – Акт постановки на баланс (регистр 1);
- Причина – Поступление от поставщика;
- Номер справки Б – Б‑202609‑00123 (если требуется)․
Пример:
ИНН: ###
Тип: Акт постановки на баланс (регистр 1)
Причина: Поступление от поставщика
Справка Б: Б‑202609‑00123
Рекомендации по заполнению шаблона - Всегда проверяйте корректность ИНН – ошибка в одной цифре приведёт к нулевому ответу․
- Если запрос требует указания периода, формат даты должен быть ДД․ММ․ГГГГ․
- Для актов списания обязательно укажите причину из утверждённого списка (порча, утрата, реализация и т․д․)․
- При работе с штрихкодами используйте функцию «Запрос на получение штрихкода», указав серию и номер марки․
- После получения ответа сохраняйте его в виде XML/JSON файла – это упрощает последующую обработку в бухгалтерских системах․
Шаблон запроса в ЕГАИС – это универсальный инструмент, который позволяет получать актуальную информацию о контрагентах, товарах, накладных и остатках алкогольной продукции․ Правильное заполнение обязательных полей (ИНН, тип операции, идентификаторы документов) гарантирует быстрый и точный ответ от системы․ Используя примеры, приведённые выше, пользователи Sh4Decl․exe могут быстро формировать нужные запросы, минимизируя риски ошибок и ускоряя работу с ЕГАИС․