Атол фискализация для RetailCRM
Выдавайте все виды чеков (оплаты, возврата и закрывающие чеки) прямо в RetailCRM.
Описание модуля Атол фискализация для RetailCRM
Скидка 40% на онлайн-кассу для всех клиентов RetailCRM.
Модуль «Атол Фискализация» подключает облачную кассу АТОЛ Онлайн к RetailCRM и автоматически формирует все виды чеков прямо из заказа по 54-ФЗ — с поддержкой обязательной маркировки и интеграцией с «Честным знаком». Настраивается под вашу схему продаж: предоплата, полный расчёт, авансы и взаиморасчёты.
Все виды чеков — автоматически
- Чеки оплаты (открытия) при поступлении предоплаты или аванса.
- Закрывающие чеки при отгрузке или полном расчёте.
- Полные возвраты по чекам оплаты и по закрывающим чекам.
- Частичные возвраты — возврат отдельных позиций заказа.
- Взаиморасчёты — отдельная логика чеков для зачётов и взаимных расчётов.
- Продажа и погашение подарочных карт и сертификатов.
Маркировка и «Честный знак»
- Передача кодов маркировки в чек в одном процессе с продажей.
- Прямая интеграция с системой «Честный знак» с проверкой кодов.
- Разрешительный режим — продажа не останавливается при временной недоступности сервиса.
Гибкая настройка под ваш учёт
- Любая система налогообложения: ОСНО, УСН «Доходы», УСН «Доходы−Расходы», ЕСХН, ПСН.
- Все ставки НДС, включая новые ставки УСН 5% и 7%, и отдельный НДС на доставку.
- Сопоставление способов оплаты RetailCRM со способами расчёта АТОЛ: наличные, карта, СБП, электронные средства.
- Тонкие правила формирования чеков по статусам заказа, статусам товаров и типам оплаты.
- Свои названия услуг «Аванс» и «Доставка» с подстановкой данных заказа.
Удобно работать прямо в RetailCRM
- Чеки видны в карточке заказа — можно проверить чек (пример).
- Автоматическая разметка заказов чеками 100% предоплаты и закрытия.
- Возврат и корректировка чека прямо из интерфейса RetailCRM, ручное переотправление.
- Несколько касс и магазинов в одной интеграции.
Чем полезно
- Фискализация по 54-ФЗ без ручной работы — чеки уходят автоматически из заказа.
- Маркировка и «Честный знак» — в едином процессе с продажей.
- Чеки видны прямо в заказе, ошибки легко поправить.
- Тонкая настройка под вашу схему продаж, налоги и кассовую дисциплину.
Для установки нажмите Подключить и следуйте инструкциям внутри модуля. При подключении специалисты проконсультируют по чекам открытия и закрытия и по вопросам маркировки. Настройка и техническая поддержка — бесплатны.
Установка и подключение Атол фискализация для RetailCRM
Для настройки интеграции создаем API ключ:
- Переходим в Настройки -> Интеграция -> Ключи доступа к API
- Нажимаем кнопку «Добавить»
- В поле «Комментарий» обязательно указываем, за какую интеграцию отвечает ключ. Например, пишем: «Интеграция с Атол»
- Выбираем магазины, к которым будет доступ у ключа API
- Выбираем разрешенные действия API (все)
- Нажимаем после «Сохранить»
После создания API ключ необходимо скопировать. Он понадобится в следующем шаге
Важно! Не используйте один и тот же API ключ для разных интеграций. Если у Вас уже созданы какие-то ключи и используются для интеграции с другими сервисами, использовать его повторно не рекомендуется. Создайте новый API ключ!
Важно! Обязательно укажите комментарий к API ключу, чтобы изменения можно было идентифицировать!
- Переходим в «Настройки», раздел «Маркетплейс» в RetailCRM
- Находим модуль «Атол фискализация для RetailCRM» (Онлайн-кассы)
- Нажимаем «Подключить»
- Переходим в Панель управления настройками модуля
- Проверяем чек-бокс активности модуля: если не активирован — сделать активацию и сохранить изменение. После этого появится кнопка «Перейти в личный кабинет»
Поле «Ссылка на RetailCRM вида: https://YOUR-DOMAIN.retailcrm.ru» — указываем ссылку на ваш RetailCRM. Для копирования этой ссылки необходимо авторизоваться в Вашей CRM и скопировать ссылку в адресной строке браузера
Поле «API-ключ RetailCRM» — в это поле сразу вставляем скопированный API-ключ
После чего сохраните настройки
Перейдите на вкладку «Аккаунты» и нажмите кнопку «Добавить аккаунт»
После чего у вас появится окошко, где нужно указать название добавляемого аккаунта и сохранить
На вкладке «Аккаунты» появится добавленный аккаунт, перейдите в редактирование
Вкладка «Основные»
Вкладка «Чеки оплат»
Вкладка «Чеки закрытия»
Вкладка «Возвраты»
Вкладка «Частичные возвраты»
Вкладка «Вкладка «Реквизиты»»
Вкладка «Покупка подарочными картами»
Вкладка «Дополнительно»
Важно! Версия ФФД должна быть 1.2
Поле «Магазины RetailCRM» — выберите магазины, с которыми будет работать модуль. В перечне магазинов будут только те, которым вы дали доступ при создании API ключа в RetailCRM
Поле «Название аккаунта» — при необходимости измените название подключения
Поля «API логин Атол», «API пароль Атол» и «Идентификатор группы ККТ Атол» заполняются из файла интегратора, скачанного из личного кабинета Атол
Чек-бокс «Использовать тестовый сервер Атол» — активируйте, если подключаете тестовый Атол
Поле «Часовой пояс» — выберите часовой пояс, который будет отображаться в чеках
Чек-бокс «Разрешительный режим» — активируйте чек-бокс, если используете разрешительный режим
Примечание. Разрешительный режим — это предварительная проверка кода маркированного товара для автоматической выдачи разрешения или запрета на его продажу
Поле «API-ключ Честного Знака» — укажите API ключ из Честного Знака, если используете разрешительный режим
Примечание. API ключ Честного Знака можно получить в личном кабинете. Подробнее по ссылке*.
Поле «Система налогообложения» — из выпадающего списка выберите вашу систему налогообложения
Поле «ИНН организации или индивидуального предпринимателя — пользователя кассы» — укажите ИНН
Поле «Email компании» — укажите email компании
Поле «Адрес места расчетов» — укажите ссылку на сайт или адрес розничного магазина
Поле «Текст для аванса» — текст, который будет отображаться в чеке аванса, можете подставить данные из заказа
Чек-бокс «Добавлять артикул к названию товара»
Поле «Текст для доставки»
После заполнения полей нажмите кнопку «Сохранить»
Чек-бокс «Создавать чеки открытия» — активирует функционал создания чеков открытия по заданным условиям
Чек-бокс «Создавать ВСЕ чеки предоплат как чеки аванса» — активирует функционал создания всех чеков оплат как авансовых. При данной опции будет игнорироваться определение аванс или предоплата, а выдаваться только аванс. Это удобно, если у вас покупатели делают дозаказ после предоплаты. В заказе предоплата может быть только одна, а авансы же могут быть множественные
Чек-бокс «Передавать X % как X/100+X%.. Например, ставку в CRM 5% как 5/105»
Поле «Веб хук на создание чека открытия. Создайте триггер в системе, на смену статуса оплаты, в котором необходимо создать чек открытия и добавьте в действие триггера — http-запрос, тип запроса Get» — этот вебхук потребуется для создания триггера пробития чека открытия, его нужно скопировать. О том, как создать триггер описано в отдельном блоке
Поле «Типы оплат в заказе с формированием чека открытия» — в этом поле выберете те типы оплат, для которых должен создаваться чек открытия. Для тех типов оплат, которые не будут указаны, чек открытия создаваться не будет, соответственно
Поле «Статусы товаров, не передаваемых в чеках» — укажите статусы товаров, находясь в которых, товары не попадут в чек
Чек-бокс «Создавать чеки возвратов для чеков открытия» — активирует функционал создания чека возврата для чека открытия, когда покупатель только оплатил заказ, не получив его
Поле «Веб хук на создание чека возврата. Создайте триггер в системе, на смену статуса оплаты, в котором необходимо создать чек возврата и добавьте в действие триггера — http-запрос, тип запроса Get» — этот вебхук потребуется для создания триггера пробития чека возврата для чека открытия, его нужно скопировать. О том, как создать триггер описано в отдельном блоке
Поле «Статусы оплат возврата платежа» — укажите те статусы оплаты, для которых будет формироваться чек возврата для чека открытия
Поле «НДС доставки» — выберите откуда брать НДС
Сохраните настройки вкладки
Чек-бокс «Создавать чеки закрытия» — активирует функционал создания чеков закрытия
Поле «Веб хук на создание чека закрытия. Создайте триггер в системе, на смену статуса заказа, в котором необходимо создать чек закрытия и добавьте в действие триггера — http-запрос, тип запроса Get» — этот вебхук потребуется для создания триггера пробития чека закрытия, его нужно скопировать. О том, как создать триггер описано в отдельном блоке
Чек-бокс «Добавлять в чек закрытия получения оплаты» — активируйте чек-бокс, если вы не выдаете чек открытия, а выбиваете сразу общий чек
Чек-бокс «Передавать X % как X/100+X%.. Например, ставку в CRM 5% как 5/105» —
Поле «Статусы заказа с отправкой чека закрытия» — укажите статусы заказа, для которых будет формироваться чек закрытия
Поле «Типы оплат в заказе с формированием чека закрытия» — в этом поле выберете те типы оплат, для которых должен создаваться чек закрытия. Для тех типов оплат, которые не будут указаны, чек закрытия создаваться не будет, соответственно
Поле «Статусы товаров, не передаваемых в чеках» — укажите статусы товаров, находясь в которых, товары не попадут в чек
Поле «Веб хук на создание чека полного возврата. Создайте триггер в системе, на смену статуса заказа, в котором клиент произвел полный возврат и добавьте в действие триггера — http-запрос, тип запроса Get» — этот вебхук потребуется для создания триггера пробития чека полного возврата, его нужно скопировать. О том, как создать триггер описано в отдельном блоке
Поле «НДС доставки» — выберите откуда брать НДС
Сохраните изменения
Выберите код платежа, который будет отображаться в чеке возврата
Сохраните изменения
Поле «Веб хук на создание чека частичного возврата. Создайте триггер в системе, на событие, в котором необходимо создать чек частичного возврата и добавьте в действие триггера — http-запрос, тип запроса Get» — этот вебхук потребуется для создания триггера пробития чека частичного возврата, его нужно скопировать. О том, как создать триггер описано в отдельном блоке
Поле «Выбор статусов товаров для возврата» — выберите статусы товаров, для которых будет возможно осуществлять частичный возврат. Частичный возврат работает и на аван, и на предоплату, и на закрывающий чек
Чек-бокс «Менять статус позиции при частичном возврате» — активируйте чек-бокс, если после частичного возврата товаров у них нужно поменять статус
Поле «Статус позиции после успешного возврата» — если активировали чек-бокс «Менять статус позиции при частичном возврате», выберите статус, на который будет меняться
Повторно осуществить частичный возврат по одному и тому же товару нельзя
Сохраните настройки вкладки
Вкладка нужна для следующего обновления модуля. Сейчас для каждого типа оплаты RetailCRM укажите «Банковская карта». Сохраните
На данной вкладке настраивается тот тип оплаты, с которым будет осуществляться продажа товаров за сертификат.
❗ Важно. Если оплата осуществляется сертификатом больше суммы заказа, то остаток сертификата сгорает. Если номинал сертификата меньше суммы заказа, то доплата осуществляется с базовым типом оплаты (любым из тех, что указан в настройке «Типы оплат в заказе с формированием чека открытия»).
Как реализовать покупку с использованием подарочной карты
Добавляется настройка – Способ оплаты, обозначающий оплату подарочной карты. Данная настройка не влияет на чек открытия, только на закрытия. Логика запускается, если в заказе есть тип оплаты подарочной карты (даже если платежей несколько и оплата картой только одна). Если случайно в заказе есть и продажа карты, и покупка карты (чисто защита), то подарочная карта из чека закрытия удаляется.
Общие правила:
- Способ оплаты «Подарочная карта» исключается из раздела «Фискализация → Оплата».
- Открывающий чек не формируется при оплате картой.
- Формируется только закрывающий чек с товарами, услугами и доставкой (если она есть в заказе).
- Остаток по карте не возвращается:
карта > сумма заказа → разница «сгорает»;
карта ≤ сумма заказа → доплата другим способом. - Если в составе заказа есть подарочная карта, то чек закрытия не выдается!
Вкладка устарела, использовать не нужно
Создание триггера для чека открытия
Создание триггера для чека возврата для чека открытия
Создание триггера для чека закрытия
Создание триггера для чека полного возврата
Создание триггера для частичного возврата
Работа с модулем в заказе RetailCRM
В RetailCRM перейдите — Автоматизация — Триггеры — добавить триггер
Укажите название триггера, например, «Чек открытия Атол» и комментарий к триггеру, если нужно. Нажмите на кнопку «Событие» и в открывшемся окне выберите «Изменение заказа»
Снизу появится кнопка «Добавить»
У вас появится две настройки. Нажмите на кнопку «Условие» — добавьте условие, на которое будет выбиваться чек оплаты. Как правило, чек оплаты выбивается на оплату заказа, т.е. можем выбрать «Изменение статуса оплаты»
Откроются условия с новым и старым значением. Выберите Начальное значение — любой, Новое значение — равняется — Оплачен. Сохраните выбор
Если у вас есть заказы, например, с сайта, которые в RetailCRM приходят уже с оплатой, то необходимо добавить еще одно условие. Нажимаем на кнопку «Условие» и в списке выбираем «Статус оплаты»
Выбираем «Равняется» — Оплачен. Сохраняем выбор
После чего меняем союз «И» между двумя условиями на «ИЛИ»
Переходим к кнопке «Действие». Нажимаем кнопку и выбираем «Выполнить HTTP-запрос»
Откроется страница, на которой в поле «Адрес» нужно указать ссылку, скопированную ранее, из поля «Веб хук на создание чека открытия. Создайте триггер в системе, на смену статуса оплаты, в котором необходимо создать чек открытия и добавьте в действие триггера — http-запрос, тип запроса Get» и сохранить настройки
После чего нажмите на зеленую кнопку «Сохранить». Триггер готов. С помощью данного триггера при изменении статуса оплаты с любого на оплачен и создание оплаченного заказа будет выбиваться чек оплаты
Добавление триггера для чека возврата происходит аналогично добавлению триггера для чека открытия, которое описано в предыдущем пункте. Поэтому сразу перейдем к событию
Нажмите на кнопку «Событие» и в открывшемся окне выберите «Изменение заказа»
Снизу появится кнопка «Добавить»
У вас появится две настройки. Нажмите на кнопку «Условие» — добавьте условие, на которое будет выбиваться чек возрата для чека открытия. В данном случае, чек возврата по чеку оплаты будет формироваться на статус оплаты — Возвращен. Т.е. выбираем «Изменение статуса оплаты»
Откроются условия с новым и старым значением. Выберите Начальное значение — любой, Новое значение — равняется — Возвращен. Сохраните выбор
Переходим к кнопке «Действие». Нажимаем кнопку и выбираем «Выполнить HTTP-запрос»
Откроется страница, на которой в поле «Адрес» нужно указать ссылку, скопированную ранее, из поля «Веб хук на создание чека возврата. Создайте триггер в системе, на смену статуса оплаты, в котором необходимо создать чек возврата и добавьте в действие триггера — http-запрос, тип запроса Get» и сохранить настройки
После чего нажмите на зеленую кнопку «Сохранить». Триггер готов. С помощью данного триггера при изменении статуса оплаты с любого на Возвращен будет выбиваться чек возврата для чека оплаты
Добавление триггера для чека возврата происходит аналогично добавлению триггера для чека открытия. Поэтому сразу перейдем к событию
Нажмите на кнопку «Событие» и в открывшемся окне выберите «Изменение заказа» — Добавить
У вас появится две настройки. Нажмите на кнопку «Условие» — добавьте условие, на которое будет выбиваться чек закрытия. Чек закрытия выбивается, когда покупатель получил свой заказ, например, на статус заказа Выполнен, т.е. можем выбрать «Изменение статуса заказа»
Откроются условия с новым и старым значением. Выберите Начальное значение — любой, Новое значение — равняется — Выполнен. Сохраните выбор
Переходим к кнопке «Действие». Нажимаем кнопку и выбираем «Выполнить HTTP-запрос»
Откроется страница, на которой в поле «Адрес» нужно указать ссылку, скопированную ранее, из поля «Веб хук на создание чека закрытия. Создайте триггер в системе, на смену статуса заказа, в котором необходимо создать чек закрытия и добавьте в действие триггера — http-запрос, тип запроса Get» и сохранить настройки
После чего нажмите на зеленую кнопку «Сохранить». Триггер готов. С помощью данного триггера при изменении статуса заказа с любого на Выполнен будет выбиваться чек закрытия
Добавление триггера для чека полного возврата происходит аналогично добавлению триггера для чека открытия. Поэтому сразу перейдем к событию
Нажмите на кнопку «Событие» и в открывшемся окне выберите «Изменение заказа» — Добавить
У вас появится две настройки. Нажмите на кнопку «Условие» — добавьте условие, на которое будет выбиваться чек полного возврата. Чек полного возврата выбивается, когда осуществляется возрат уже полученного и оплаченного заказа, например, на статус заказа Возврат, т.е. можем выбрать «Изменение статуса заказа»
Откроются условия с новым и старым значением. Выберите Начальное значение — любой, Новое значение — равняется — Возврат. Сохраните выбор
Переходим к кнопке «Действие». Нажимаем кнопку и выбираем «Выполнить HTTP-запрос»
Откроется страница, на которой в поле «Адрес» нужно указать ссылку, скопированную ранее, из поля «Веб хук на создание чека полного возврата. Создайте триггер в системе, на смену статуса заказа, в котором клиент произвел полный возврат и добавьте в действие триггера — http-запрос, тип запроса Get» и сохранить настройки
После чего нажмите на зеленую кнопку «Сохранить». Триггер готов. С помощью данного триггера при изменении статуса заказа с любого на Возврат будет выбиваться чек полного возврата
Добавление триггера для чека частичного возврата происходит аналогично добавлению триггера для чека открытия. Поэтому сразу перейдем к событию
Нажмите на кнопку «Событие» и в открывшемся окне выберите «Изменение заказа» — Добавить
У вас появится две настройки. В блоке «Условие» перейдите в «Редактор» и вставьте этот код:
(changeSet.hasChangedField(‘order_product.status’) and changeSet.newValue(‘order_product.status’).code in [‘символьный код статуса товара’])
Замените выделенное значение на статус товара, для которого будет осуществляться частичный возврат. Чтобы найти символьный код нужного вам статуса товара, откройте новую вкладку RetailCRM, перейдите в Настройки — Статусы — Статусы товаров и услуг. Откроется таблица со всеми статусами товаров, заведенных у вас в системе
Найдите нужный, например, в данном случае, выбираем статус товара «Возврат» и копируем его символьный код
После чего, этот символьный код указываем в триггере
Условие срабатывания триггера готово. Триггер будет срабатывать на изменение статуса товара с любого на «Возврат»
Переходим к кнопке «Действие». Нажимаем кнопку и выбираем «Выполнить HTTP-запрос»
Откроется страница, на которой в поле «Адрес» нужно указать ссылку, скопированную ранее, из поля «Веб хук на создание чека частичного возврата. Создайте триггер в системе, на событие, в котором необходимо создать чек частичного возврата и добавьте в действие триггера — http-запрос, тип запроса Get» и сохранить настройки
После чего нажмите на зеленую кнопку «Сохранить». Триггер готов. С помощью данного триггера при изменении статуса товара с любого на «Возврат» будет выбиваться чек частичного возврата на те товары, которые находятся в указанном статусе
Все пробитые чеки по заказу отображаются в блоке «Оплата» в заказе RetailCRM. Для того, чтобы посмотреть чеки по конкретному заказу, нажмите на кнопку «Фискальные чеки Атол». Справа откроется окно, в котором будут отображаться все чеки.
Частые вопросы о Атол фискализация для RetailCRM
Модуль имеет возможности работы с маркировкой товаров?
Да. У нашего модуля широкие возможности маркировки: передача кодов в чек и интеграция с «Честным знаком» с проверкой кодов.
Можно ли создать чеки по заказам, созданным до установки модуля?
Да. Возможно создать чеки по старым заказам, указав их ID.
Поддерживает ли модуль новые ставки НДС УСН 5% и 7%?
Да. Модуль поддерживает все актуальные ставки НДС, включая новые ставки УСН 5% и 7%, а также отдельную ставку НДС для доставки.
Можно ли подключить несколько касс или магазинов?
Да. В одной интеграции можно настроить несколько касс АТОЛ и привязать их к нескольким магазинам RetailCRM.
Поддерживаются ли частичные возвраты?
Да. Модуль оформляет как полный возврат заказа, так и возврат отдельных позиций (частичный возврат), а также взаиморасчёты.
Что делать, если касса выдаёт ошибку по коду маркировки (например, 126)?
Почти всегда дело в настройках 2D-сканера, а не в самом модуле или товаре — сканер должен считывать код маркировки полностью, включая служебные символы-разделители. Разобрали симптом, причину и починку по шагам: «Частые ошибки Честного знака: код 126 и другие».
Поддержка модуля Атол фискализация для RetailCRM
Проконсультируем, поможем настроить модуль и решить вопросы по работе. При необходимости — делаем видеосозвоны.
Telegram
mail@studia-crm.ru