1С: Управление торговлей ред. 11.4-11.5, Комплексная автоматизация ред. 2.4-2.5 и ERP 2.4-2.5

Общая информация

В программе реализованы алгоритмы взаимодействия с системой АТОЛ Онлайн посредством стандартного API компании (с информацией можно ознакомиться по ссылке https://atol.online/library/).

Настройки

• Все основные настройки вынесены в "Форму настроек АТОЛ Онлайн”

• "Форма настроек АТОЛ Онлайн" - открывает форму, в которой необходимо указать данные для подключения к системе.

Если отправка чеков происходит от нескольких организаций, то задайте значения для каждой.

Получение списка ИНН

Получение списка ИНН доступно начиная с версии 1.2.0.0

Для получения списка ИНН, от которых доступна отправка чеков в АТОЛ Онлайн для вашей конфигурации:

• Откройте форму настроек АТОЛ Онлайн

• Перейдите на вкладку "Лицензии"

• Введите логин и пароль, полученный в отделе продаж

• Нажмите "Сохранить логин и пароль"

• Нажмите "Обновить информацию по лицензии"

В случае возникновения сложностей при получении лицензии свяжитесь с отделом продаж компании ЗетаСофт.

Основные настройки

• Версия API - в зависимости от версии ФФД ККТ выберите соответствующую версию API. Для ФФД 1.05 - версия v4, для ФФД 1.2 - версия v5

Версию ФФД своей кассы можно уточнить в компании АТОЛ Онлайн

• Логин - логин пользователя для отправки данных (информация содержится в файле в поле login, доступном в личном кабинете АТОЛ Онлайн, подробнее в разделе Получение настроек в АТОЛ Онлайн)

• Пароль - пароль пользователя для отправки данных (информация содержится в файле в поле password, доступном в личном кабинете АТОЛ Онлайн, подробнее в разделе Получение настроек в АТОЛ Онлайн)

• group code - идентификатор группы ККТ (информация содержится в файле в поле group_code, доступном в личном кабинете АТОЛ Онлайн, подробнее в разделе Получение настроек в АТОЛ Онлайн)

• Платёжный адрес - место расчетов, при наличии нескольких мест расчетов добавьте каждое в отдельную строку (информация содержится в файле в поле shop hostname, доступном в личном кабинете АТОЛ Онлайн, подробнее в разделе Получение настроек в АТОЛ Онлайн)

Начиная с релиза 1.3.7.0 добавлен справочник АТОЛ_МестаРасчетов, в котором помимо платежного адреса хранятся:

• Флаг "Признак расчета в интернет"

• Часовая зона

Флаг "Признак расчета в интернет" и Часовая зона в новом чеке заполняются из места расчетов и при необходимости могут быть изменены в созданном чеке до отправки

• Вид контактной информации адрес эл. почты - вид контактной информации в карточке контрагента, в которой хранится адрес электронной почты для отправки письма

• Вид контактной информации телефон - вид контактной информации в карточке партнера, в которой хранится телефон для отправки смс

• Вид контактной информации адрес эл. почты организации - вид контактной информации в карточке организации, в которой хранится адрес электронной почты для добавления в чек (адрес отправителя)

• Флаг "Отправлять чек на телефон"

• Флаг "Отправлять чек на почту"

• Формулировка авансового платежа - автоматически будет подставляться в содержание при отправке чеков на аванс из документов оплаты

• Cтавка НДС - ставка НДС для авансового платежа

Если включены оба флага отправки чека (и на телефон, и на эл. почту), то сработает следующий алгоритм:

• Если заполнена эл. почта, то чек отправится только на эл. почту

• Если эл. почта не заполнена, то чек отправится телефон

Обращаем внимание, что для отправки чеков на телефон необходимо, чтобы эта опция была доступна у вашего ОФД, а также оплачен необходимый пакет.

Номер телефона необходимо передать вместе с кодом страны без пробелов и дополнительных символов, кроме символа «+» (номер «[phone]» необходимо передать как «[phone]»). Если номер телефона относится к России (префикс «+7»), то значение можно передать без префикса (номер «[phone]» можно передать как «9251234567»). Максимальная длина строки – 64 символа.

Дополнительные настройки

• Заполнять наименование из контрагента - при установленном флаге в чек будет передаваться полное наименование контрагента

• Заполнять ИНН контрагента - при установленном флаге в чек будет передаваться полное ИНН контрагента

В версии ФФД 1.2 при заполнении Наименования клиента обязательно должен быть заполнен ИНН. В релизе модуля добавлено соответствующее предупреждение в чек.

• Не проверять Юр/Физ лицо - по умолчанию происходит проверка на то, что контрагент - физическое лицо, при создании чека для юр. лица в чеке будет соответствующее предупреждение

• Отображать результат отправки чека - после отправки чека будет форма со списком отправленных чеков

• Отправлять чеки без подтверждения - форма со списком созданных чеков к отправке не будет отображаться, созданные чеки будут сразу отправляться в АТОЛ Онлайн

• Не отправлять чеки с предупреждениями - если по чеку есть предупреждения перед отправкой, чек не будет отправлен

• Заполнять внутренний идентификатор из УИД документа основания - при выключенной настройке внутренний идентификатор для каждого нового документа чек будет генерироваться произвольно. При включенной настройке внутренний идентификатор заполняется из документа основания для чека

Внутренний идентификатор документа чек используется системой АТОЛ Онлайн для проверки, был ли ранее отправлен чек или нет. Если из 1С будет отправлен чек с внутренним идентификатором, по которому чек уже был зарегистрирован ранее, то АТОЛ Онлайн не создаст новый чек, а вернет информацию о ранее созданном чеке.

Это сценарий можно воспроизвести если отправить сначала чек на отгрузку в кредит из реализации (документом основанием для чека будет реализация) и позже отправить чек на оплату кредита (документом основанием будет та же реализация) - в этом случае второй чек не отправится.

Мы рекомендуем не включать эту настройки без осознанной необходимости передавать во внутренний идентификатор УИД документа основания.

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

• Выводить информацию о платежном агенте - при включенной настройке в документе АТОЛ Чек для каждой строки в Объектах расчета появится возможность заполнить информацию об агенте и поставщике. При необходимости можно настроить автоматическое заполнение данных об агенте в чеке (подробнее в разделе Данные об агенте в чеке)

• Тестовый режим - необходимо включить при работе с тестовой средой АТОЛ Онлайн

• Отображать информацию о кассире в чеке и передавать в АТОЛ Онлайн - при включенной настройке в чеке будет отображаться информация о кассире и появится возможность его заполнения (кассир не является обязательным полем при работе с облачной кассой)

• Кассир по умолчанию - значение по умолчанию для новых чеков (составной тип данных: справочник Пользователи и Строка)

• Заполнять кассира в чеке ответственным пользователем из документа - при включенной настройке кассир в чеке будет заполняться ответственным из документа

• Использовать дополнительные кассы - при включенной настройке появляется возможность добавить дополнительные кассы для организации и выбирать их в чеке (подробнее в разделе Дополнительные кассы)

Честный знак (разрешительный режим)

Настройки для проверки кодов маркировки для товаров с разрешительным режимом появились в релизе 1.3.5.0

Ниже приведены настройки, которые используются в релизах типовой конфигурации (задаются в коде)

Алгоритм работы модуля с разрешительным режимом описан в разделе Разрешительный режим

Начиная с релиза 1.3.6.0 доступна проверка разрешительного режима средствами основной конфигурации 1С, которая поддерживает проверку как в режиме онлайн, так и в режиме офлайн

Для проверки разрешительного режима средствами основной конфигурации необходимо включить соответствующий переключатель "Проверка кодов маркировки типовыми средствами 1С". В этом случае токен всегда будет получаться из типового хранилища Токена авторизации ИС МП Розница

• Идентификатор ФОИВ (тег 1262) - значение "030"

• Дата нормативного акта федерального органа исполнительной власти, регламентирующего порядок заполнения реквизита «значение отраслевого реквизита» (тег 1263) - значение "21.11.2023"

• Номер нормативного акта федерального органа исполнительной власти, регламентирующего порядок заполнения реквизита «значение отраслевого реквизита» (тег 1264) - значение "1944"

• Флаг "Получать токен авторизации ИС МП Розница из настоек АТОЛ" - при включенном флаге появится дополнительное поле, где можно указать токен авторизации. При выключенном флаге токен получается из типового регистра сведений ДанныеКлючаСессииИСМП по Организации и типу токена "ИС МП Розница"

• Периодичность проверки площадки CDN - у Честного знака несколько площадок, при проверке площадок определяется адрес с минимальным временем ответа. В этом параметре задается периодичность для повторной проверки. Проверка происходит автоматически при отправке чеков. Также при необходимости можно выполнить проверку вручную на форме настроек

Инструкция по получения токена авторизации - https://markirovka.ru/community/rezhimproverok-na-kassakh/rezhim-proverok-na-kassakh

Получение настроек в АТОЛ Онлайн

• Логин, пароль, платёжный адрес (shop hostname) и group code для отправки данных можно получить из файла настроек для CMS в личном кабинете пользователя. Для этого необходимо зайти в личный кабинет пользователя. Переходим на сайт https://online.atol.ru/ и в правом углу нажимаем “Вход в личный кабинет”

• После авторизации в личном кабинете на главной странице (раздел “Мои компании”) нажимаем кнопку “Настройки интегратора”.

• В результате будет скачан XML файл, содержащий необходимую информацию:

Тестовые настройки

Для тестирования можно использовать параметры тестовой среды АТОЛ (также необходимо включить флаг «Тестовый режим» в форме настроек и для организации изменить ИНН) - https://online.atol.ru/files/ffd/test_sreda.txt

Начиная с версии 1.3.0.0 заполнение данных тестовой среды происходит автоматически при установленном флаге "Тестовый режим" и выборе версии API.

ИНН для организации, от которой идет отправка чеков в тестовую среду, необходимо изменить вручную на ИНН АТОЛ - 5544332219 (начиная с релиза 1.3.5.0 не требуется изменение ИНН у организации в 1С для работы с тестовой средой АТОЛ Онлайн)

АТОЛ Онлайн Чек

Отправка чека в АТОЛ Онлайн происходит из документа (АТОЛ Онлайн) Чеки

Документ (АТОЛ Онлайн) Чек повторяет структуру API АТОЛ Онлайн и передача данных происходит из него. При необходимости пользователь может проконтролировать данные и при необходимости отредактировать их перед отправкой. Заполнение документа (АТОЛ Онлайн) Чек из типовых документов описано ниже.

Дополнительные реквизиты чека

На вкладке Дополнительно есть возможность заполнить дополнительные реквизиты чека

• Дополнительный реквизит чека - значение из этого реквизита будет передано в тег 1192 в чеке, в который рекомендуется указать фискальный признак (ФПД) ошибочного чека. Максимальная длина - 16 символов

• Дополнительный реквизит пользователя - значения из реквизитов Наименование (максимальная длина 64 символа) и Значение (максимальная длина 256 символов) будут переданы соответственно в теги 1085 и 1086

Данные по дополнительному реквизиту пользователя не передаются для чеков коррекции

Информация об отправленных чеках

Информация об отправленных чеках хранится в регистре сведений "Отправленные чеки АТОЛ Онлайн". Для пользователя есть несколько вариантов получить информацию об отправленном чеке:

• Признак успешной отправки, предупреждений и ошибок отправки отображается в форме списка чеков

Ошибка в чеке - предупреждения до передачи чека в АТОЛ Онлайн. В них выводится информация о возможных ошибках, которые необходимо проверить

Ошибка отправки - в результате отправки от сервиса АТОЛ Онлайн ответ с ошибкой. Текст ошибки и код ошибки выводятся в служебных сообщениях. Расшифровка кодов ошибок по ссылке - коды ошибок АТОЛ Онлайн

• Из формы документа нажать на кнопку "Проверить регистрацию чека". В служебных сообщениях будет отображена информация по чеку

Контроль при отправке

В типовом функционале модуля заложен следующий контроль:

• Из документа оплаты/отгрузки нажали "Отправить чек". Система проверяет флаг "Отправлять без подтверждения".

• Если стоит - то проверяет наличие предупреждений.

• Если их нет - попытка отправить.

• Если предупреждения есть и есть флаг "Не отправлять с предупреждением" то откроется форма с записанными чеками без попытки отправить.

• В форме списка команда "Отправить чеки будет доступна и если вызвать - она вне зависимости от предупреждений отправит чек (эта команда равноценна команде из самого чека).

Список чеков

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

Данные на форме:

• Признак отправки - "Отправлен"

• Признак наличия предупреждения в чеке - "Ошибка в чеке"

• Признак ошибки отправки (ответ с ошибкой от АТОЛ Онлайн) - "Ошибка отправки"

• Ссылка на документ (АТОЛ Онлайн) Чек

• Сумма чека

• Сумма документа

• Признак способа расчета:

  • full_prepayment – предоплата 100%. Полная предварительная оплата до момента передачи предмета расчета.

  • prepayment – предоплата. Частичная предварительная оплата до момента передачи предмета расчета.

  • advance – аванс.

  • full_payment – полный расчет. Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета.

  • partial_payment – частичный расчет и кредит. Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит.

  • credit – передача в кредит. Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит.

  • credit_payment – оплата кредита. Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита).

• Дата отправки чека в АТОЛ Онлайн

Заполнение документа АТОЛ Онлайн Чек

Реализация

Выбор варианта отправки чека доступен в документах "Реализация товаров и услуг" и "Акт выполненных работ":

При нажатии происходит заполнение документа (АТОЛ Онлайн) Чек:

• в табличную часть "Объекты расчета" переносятся товары и услуги в соответствии с выбранным признаком способа расчета

• в табличную часть "Платежи" переносится информация об оплате. Документы подбираются, опираясь на расчёты по документу

В соответствии с основными настройками чек будет отправлен без предупреждения или сначала отобразится окно с созданными, но не отправленными чеками.

Если при отправке чека на отгрузку в кредит будут обнаружены зачтенные платежи по документу - то признак способа расчета будет изменен с "Кредит" на "Частичный расчёт и кредит". В качестве платежа для кредита будет всегда как минимум 1 строчка на полную или оставшуюся сумму документа с видом "Кредит".

Документы оплаты

Выбор варианта отправки чека доступен в документах оплаты (поступление на расчетный счет, поступление наличных, операция по платежной карте):

Чек на предоплату

В соответствии с распределением документа оплаты будет создан один или несколько чеков с признаком способа расчёта Предоплата 100%.

Чек на аванс

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

Чек на оплату кредита

В соответствии с распределением документа оплаты будет создан один или несколько чеков с признаком способа расчёта Оплата кредита.

Возвраты

Функционал поддерживается начиная с версии 1.2.0.0

Отправка чеков доступна из следующих документов:

• Возврат товаров от покупателя;

• Корректировка реализации;

• Расходный кассовый ордер;

• Эквайринговая операция;

• Списание безналичных ДС/Списание с расчетного счета.

В верхней части самого чека имеется реквизит "Вид операции", который проставляется автоматически в зависимости документа из которого сформирован чек.

В случае, если при возврате было списание средств или РКО (т.е. деньги клиенту вернулись) , эти данные также будут отображены в чеке на вкладке Платежи.

Создание чеков коррекции

Чеки коррекции создаются в 1С вручную. Изначально, как и любой другой чек, можно создать его на основании документа 1С или Чека АТОЛ и изменить необходимые данные перед отправкой.

Для ФФД 1.05 доступны только 2 вида операции коррекции - Коррекция прихода и Коррекция расхода, для ФФД 1.2 дополнительно доступны Коррекция возврата прихода и коррекция возврата расхода

При выборе вида операции коррекции появляется доступной вкладка Коррекция, где можно указать следующие данные:

• Тип коррекции - доступны 2 значения "Самостоятельная операция" и "Операция по предписанию налогового органа", передается в тег 1173

• Номер предписания налогового органа - номер документа основания для коррекции. Заполняется в случае, если коррекция расчета осуществляется по предписанию налогового органа об устранении выявленного нарушения законодательства Российской Федерации о применении ККТ (максимум 32 символа), передается в тег 1179

• Дата чека - дата совершения корректируемого расчета в формате, передается в тег 1178

Особенности конфигурации

Детализация расчетов по заказам

Если в соглашении детализация расчетов "По заказам", то при полной оплате по заказу и отгрузке заказа несколькими документами в чек будет попадать полная сумма оплаты и в этом случае в чеке будет предупреждение о различия в сумме объектов расчетов и платежей. В этом случае необходима ручная корректировка суммы платежей в чеке перед отправкой.

Корректировка реализации

• Объекты расчета в чеке, создаваемом из Корректировки реализации, заполняются только данными с вкладки Расхождения, у которых отрицательное количество. Чек создается на Возврат прихода.

• Платежи в чеке на возврат, созданном из корректировки реализации не заполняются автоматически, т.к. этих данных нет в виде документов, связанных с корректировкой реализации. В созданном чеке перед отправкой необходимо вручную заполнить вкладку платежи с указанием видов оплаты, сумм и документов (при необходимости)