Настройка интеграции с Честным знаком
Нет времени читать?
Статья в разработке!
Актуально для релиза 2.8.3.1.
Содержание
Введение
См. основную статью "Маркировка товаров", а также другие статьи в разделе Базы знаний "Маркированные товары".
Предварительно должны быть сделаны следующие настройки:
1. Настройка интеграции с API 5S AUTO.
2. Настройка пользователя 5S Cloud – для доступа в приложение 5S Sign.
3. Регистрация в системе “Честный знак” – см. статью.
Настройка интеграции в программе
1. Настройка справочников номенклатуры
Для учета маркированного товара в программе требуется создать новые типы номенклатуры, либо настроить существующие.
Для каждой группы маркированных товаров рекомендуется создать отдельный тип номенклатуры, а также разделять фасованные товары и в бочках и учитывать, является ли товар подакцизным:
● моторные масла фасованные;
● моторные масла в бочках;
● тех. жидкости фасованные;
● тех. жидкости в бочках;
● шины;
и прочие при необходимости.
Создать новый тип номенклатуры можно путем добавления нового элемента в справочнике “Типы номенклатуры” или копирования имеющегося:
Основные параметры
В создаваемом типе номенклатуры следует заполнить все основные параметры:
● Наименование – заполнить наименование типа номенклатуры. Для моторных масел можно уточнить, например, фасованное / на розлив.
● Вид номенклатуры – выбрать подходящий вид: для шин есть специальный вид “Шины”, для масел и запчастей следует выбрать вид “Товар”,
● Основная базовая единица измерения – например, штуки для фасованного масла или литры для масла в бочках на розлив. Необходимо корректно указывать значение данного параметра.
● Ведение учета по – например, в случае наличия патента у организации продажу подакцизных товаров по нему проводить нельзя, поэтому для моторных масел нужно будет указать систему учета “УСН” или ”ОСНО”. В то же время для продажи запчастей может быть выбран “ПСН”;
● Единицы измерения – требуется заполнить.
Признак предмета расчета
Для маркированного товара предусмотрено несколько вариантов признака предмета расчета – необходимо выбрать подходящий:
Признаки предмета расчета для маркированных товаров:
| Значение реквизита (тег 1212) |
Реквизит “наименование предмета расчета” (тег 1030) |
Формат данных реквизита ФД в печатной форме |
| Для моторных масел и других подакцизных товаров: | ||
| 31 | реализуемый подакцизный товар, подлежащий маркировке средством идентификации, имеющий код маркировки | АТМ |
| Для шин и других товаров, НЕ являющихся подакцизными: | ||
| 33 | реализуемый товар, подлежащий маркировке средством идентификации, имеющий код маркировки, за исключением подакцизного товара | ТМ |
Подробнее см. приложение № 2 Приказа ФНС России от 14.09.2020 № ЕД-7-20/662@ ("Форматы фискальных документов, обязательных к использованию").
Маркировка
Далее необходимо произвести настройки в разделе “Маркировка”:
1) Ведется маркировка – признак ведения учета по маркировкам для данного типа номенклатуры с указанием даты начала (текущая дата начала работы в базе с маркированными товарами);
2) Учет кодов маркировки по каждой единице – настройка для учета штучного и фасованного товара. Для товара, продаваемого на вес или по литражу данный признак должен быть снят.
Пример: Для моторных масел в канистрах данный признак должен быть установлен, для масла “на розлив” из бочки – должен быть снят:
В первом случае отслеживание движения кодов маркировки будет происходить автоматически, во втором случае код маркировки считывается при поступлении бочки масла, товар приходуется и реализуется в литрах, автоматического выбытия из оборота не произойдет – потребуется вручную сканировать код маркировки на бочке и выводить из оборота.
Установка данного признака блокирует проведение документов в случае, если кодов маркировки в нем отсканировано меньше, чем указано количество номенклатуры.
3) Маркировка обязательна – признак требует обязательного наличия кодов маркировки для всего количества товара (активирует сверку количества кодов маркировки с количеством товара).
4) Использовать разрешительный режим – признак включает разрешительный режим онлайн проверки кодов маркировки перед пробитием чека и активирует запрос данных сервиса ГИС МТ “Честный знак” при продаже маркированного товара данного типа (с ноября 2024 г. обязательно для шин – см. статью):
5) Тип маркировки – выбор категории маркируемого товара, активируется при установке признака "Ведется маркировка", используется для корректной передачи кода в кассовый аппарат.
Тип номенклатуры обязательно должен быть корректно указан в карточках номенклатуры для каждого маркированного товара:
Столбцы с кодами маркировки в документах (см. в статье) будут отображаться только при корректной настройке типа номенклатуры и указании правильного типа в карточке товара.
Примечание: В начале работы с функционалом учета маркированного товара требуется корректно настроить номенклатуру в программе. В случае если для масел и автожидкостей уже были созданы соответствующие типы номенклатуры, следует просто настроить их – установить признаки в разделе “Маркировка” и выбрать корректное значение параметра “Признак предмета расчета”. В случае если ранее в своей учетной системе тип номенклатуры был указан некорректно, рекомендуется сначала списать остатки склада, затем создать, настроить и заменить типы номенклатуры в карточках товаров, затем оприходовать данные товары заново.
2. Создание интеграции с Честным знаком
Для обмена данными с Честным знаком необходимо добавить и настроить интеграцию:
Требуется заполнить реквизиты:
● Наименование – будет заполнено автоматически при записи;
● Вид интеграции – выбрать “Честный знак”;
● Обработчик подключения – “Интеграция с Честным Знаком”.
Далее следует установить отметку “Включено” и записать созданную интеграцию.
При записи интеграции в программе автоматически создаются:
● действие “Ссылка для получения токена Честный знак”;
● шаблон сообщений “Сообщение для получения токена Честный знак”;
● значимое событие “Отправка ссылок для получения токена Честный знак”;
● действие на значимое событие “Отправить ссылку для получения токена Честный знак”;
● добавляется обработка "Обновление токена API Честный знак" в меню интерфейса.
Далее на вкладке “Параметры сервиса” требуется заполнить интеграцию с API 5S AUTO:
Затем необходимо перейти на вкладку “Подразделения” и заполнить подразделения, которые будут работать с интеграцией:
Примечание: Указанные подразделения обязательно должны принадлежать одной организации. В случае если у компании несколько организаций, которые являются участниками оборота маркированных товаров и у которых есть ЛК в “Честном Знаке”, то необходимо создавать отдельную интеграцию с “Честным знаком” для каждой организации.
Если подразделения, указанные на вкладке “Подразделения” будут принадлежать разным организациям, при переходе к настройкам подключения (см. ниже) будет выходить предупреждение программы:
Далее следует перейти на вкладку “Методы интеграции → Настройки”:
В параметр “Организация” при записи подтягивается организация, которой принадлежат подразделения, указанные на вкладке “Подразделения” в настройке интеграции – см. выше. Выбрать вручную организацию нельзя.
При записи интеграция переименовывается в формате “Честный знак + Название организации”:
3. API токен
В поле “Токен” отображается информация об активности текущего токена для интеграции с API “Честного знака” для проверки кодов маркировки.
API токен – это временный пароль, с помощью которого можно взаимодействовать с API Честного знака от имени сотрудника организации.
В программе настроено получение токена через расширение КриптоПро браузера. Для подписания токена используется приложение 5S Sign (sign.5systems.ru). Для этого в формируемую ссылку передается кодовая строка, полученная в “Честном знаке”, после ее подписания сертификатом происходит получение токена.
Примечание: Работа с маркировками в программе возможна без получения токена путем сканирования кода маркировки как на этапе приемки, так и на этапе выдачи товара.
После получения токена открываются следующие возможности в программе:
1. Проверка состояния кода маркировки
2. Получение информации
3. Расшифровка кода
4. Автоматический вывод кодов маркировки из оборота
1) Получение токена
Нажатием на кнопку “Обновить” открывается окно “Обновление токена” с QR-кодом. Следует нажать кнопку “Открыть ссылку в браузере” либо "Скопировать" и вставить ссылку в поисковую строку браузера:
Важные комментарии:
1. Рекомендуется использовать Яндекс-браузер.
2. В браузере должно быть установлено расширение КриптоПро (см. в статье “Регистрация в системе Честный знак”).
3. Необходима учетная запись в 5S Cloud.
При открытии ссылки в браузере производится переход к авторизации в 5S Cloud:
Необходимо ввести учетные данные пользователя 5S Cloud – имя и пароль. При этом открывается приложение 5S Sign. На странице “Создание подписи” следует выбрать сертификат и нажать кнопку "Создать подпись":
При этом появится токен:
Информация о новом токене автоматически приходит в программу и отображается на форме настройки интеграции в поле “Токен”:
Важно: Токен обновляется на 8 часов – это срок его действия.
Получить токен можно также через специальную обработку – см. в статье “Получение токена доступа к API Честного знака”.
2) Изменение токена
Полученный токен при необходимости можно изменить – для этого нужно нажать кнопку “Изменить текущий токен Честного знака”:
Также есть возможность скопировать токен, например, для проверки его с помощью сторонних программ – для этого используется кнопка “Скопировать”:
3) Автоматическое обновление токена
В разделе “Обновление токена” следует открыть для настройки регламентное задание ”Отправка ссылок для получения токена Честный Знак”:
Следует настроить расписание для регламентного задания, также есть возможность запустить его вручную.
4) Настройка значимого события для отправки ссылок
О настройке значимого события для отправки ссылок – см. ниже в разделе “Настройка рассылки”:
Ссылка будет приходить пользователям, указанным в таблице “Ответственный за обновление токена”:
4. Токен для ККТ
В случае использования разрешительного режима для проверки кодов маркировки (для продажи шин) необходимо в разделе “Разрешительный режим” заполнить параметр “Токен для ККТ”:
Токен для ККТ – это ключ доступа для проверки кодов маркировки в разрешительном режиме. Его следует получить в личном кабинете на сайте “Честного знака” (“Профиль” → “Данные участника” → “Участие в системе” → в поле “Токен для контрольно-кассовой техники” нажать кнопку “Сгенерировать токен” – см. инструкцию):
5. Автоматический вывод из оборота маркировок
В поле “Вывод из оборота” следует открыть для настройки регламентное задание ”Автоматический вывод из оборота маркировок”:
Следует настроить расписание для регламентного задания, также есть возможность запустить его вручную.
6. Получение информации о статусах
В блоке “Дополнительно” производится настройка регламентного задания “Получение информации о статусах кодов маркировки”:
Также в блоке "Дополнительно" расположен признак “Тестовый контур”, который используется для тестирования интеграции с сервисом – при его установке будет использоваться другой сервер.
7. Настройка рассылки
При записи интеграции создается значимое событие “Отправка ссылок для получения зашифрованных данных Честный знак”:
Дополнительно ничего настраивать не требуется.
При срабатывании значимого события выполняется регламентное задание “Отправка ссылок для получения зашифрованных данных Честный знак”.
Используется типовой функционал отправки ссылки:
Шаблон сообщения для отправки ссылки:
Канал доставки – по умолчанию используется Telegram.
Для всех пользователей, указанных ответственными за обновление токена (см. выше) необходимо проверить наличие связки: Чат Telegram – Контрагент – Сотрудник – Пользователь.
При необходимости требуется настроить и создать чат Telegram – сотруднику нужно будет написать сообщение боту компании.
-
Необязательно:
-
Уточните, пожалуйста, почему: