1С на управляемых формах

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

В программе реализованы алгоритмы взаимодействия с системой АТОЛ Онлайн посредством стандартного 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тавка НДС - ставка НДС для авансового платежа

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Устанавливать количество 1 и менять цену у проблемных строк - при включенной настройке строки у которых Цена * Количество <> Сумме (с учетом округления до 2 знаков) будут автоматически изменены: Цена = Сумма, Количество = 1

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

  • Логин, пароль, платёжный адрес (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

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

Новые теги в чеках с 01.09.2025

С 1 сентября 2025 года изменились требования к оформлению кассовых чеков - см. приказ ФНС России от 26.03.2025 № ЕД-7-20/236@.

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

Требования, согласно данному приказу, были реализованы в версии модуля 1.3.7.0.

Более подробно о требованиях и как они реализованы в модуле АТОЛ Онлайн:

  • при продаже маркированных товаров в уведомлении о реализации должен быть новый реквизит "Часовая зона" (тег 1011).

  • при осуществлении расчетов в интернете в электронном кассовом чеке должен быть новый реквизит – "Признак расчета в интернете" (тег 1125).
    Кроме того, необходимо включать в электронный кассовый чек уже существующий реквизит "Место расчетов" (тег 1187).

В версии модуля 1.3.7.0 данные реквизиты доступны к заполнению на Форме настроек АТОЛ Онлайн.

Если вы ранее уже пользовались модулем, то предварительно нажмите Еще → Сконвертировать платежные адреса, чтобы сконвертировать уже ранее внесенную запись.

В строке Платежный адрес устанавливаются настройки из справочника Места расчетов АТОЛ Онлайн, где необходимо заполнить:

  • платежный адрес

  • признак расчета в интернет

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

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

Таким образом, в обновлении модуля учтена передача данных реквизитов в АТОЛ Онлайн.

Отображение данных реквизитов в чеке ОФД или АТОЛ регулируется на их стороне и не относится к работе модуля.

Если вы столкнулись с тем, что в ЛК АТОЛ или ЛК ОФД данные реквизиты в чеке отсутствуют, рекомендуется обратиться с данным вопросом к ним в техподдержку.
Передачу данных реквизитов из модуля вы можете проверить в тексте запроса JSON, открыв соответствующий чек в регистре Отправленные чеки АТОЛ Онлайн.

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

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

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

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

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

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

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

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

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

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

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

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

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

Список чеков

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

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

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

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

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

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

  • Сумма чека

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

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

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

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

    • advance – аванс.

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

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

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

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

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

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

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

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

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

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

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

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