Облачные кассы

АТОЛ Онлайн: как подключить облачную кассу и начать работу

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

2 мин чтения Связаться с техподдержкой
Содержание
  1. Как проходит платёж и где появляется чек
  2. Что подготовить перед подключением
  3. Запуск интеграции: от заявки до результата
  4. Как не получить два чека на одну оплату

Как проходит платёж и где появляется чек

Покупатель оплачивает заказ, платёжный сервис сообщает результат, а магазин передаёт сведения для чека. Облачный сервис обрабатывает запрос и возвращает результат фискализации. Эти события связаны, но не совпадают по времени: успешная оплата ещё не подтверждает готовность чека.

Для конкретного бизнеса заранее определяют, допустима ли выбранная удалённая схема применения ККТ и какие чеки нужны: предоплата, окончательный расчёт, возврат. Это зависит от расчёта, а не только от того, есть ли у магазина сайт.

Что подготовить перед подключением

  • Реквизиты пользователя ККТ, место и адрес расчётов, систему налогообложения и применяемые ставки.
  • Сценарии оплаты и возврата, товарные наименования, количество, цену, признак способа и предмета расчёта.
  • Контакты покупателя для предусмотренной отправки электронного чека.
  • Ответственного за регистрацию ККТ, подключение ОФД и проверку карточки.

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

Запуск интеграции: от заявки до результата

  1. Настройте кабинет и регистрацию

    Оформите подключение по действующим условиям сервиса. Убедитесь, что кассы зарегистрированы с правильными реквизитами и готовы к работе.

  2. Выберите поддерживаемый способ обмена

    Для готового модуля магазина используйте инструкцию его разработчика. Для собственной интеграции сверьте актуальный API, версию формата и схему авторизации.

  3. Проверьте сценарии в тестовой среде

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

  4. Включите контроль результатов

    Сохраняйте идентификатор запроса и итоговый статус. Ответ о приёме задания с UUID ещё не означает, что фискальный документ сформирован. Обрабатывайте callback или запрашивайте результат предусмотренным методом.

Как не получить два чека на одну оплату

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

Отдельно ведите очередь задач, завершившихся ошибкой. Исправленный запрос должен оставаться связанным с исходным заказом. Подробности обмена — в статье об API АТОЛ.

Частые вопросы

Облачная касса заменяет интернет-эквайринг?

Нет. Эквайринг принимает оплату, а касса оформляет фискальный документ. В одном сервисе могут быть доступны обе услуги, но проверяют их отдельно.

Можно ли считать заказ обработанным сразу после отправки чека?

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

Документация, по которой сверяли статью
  • АТОЛ Онлайн, руководство по API и справка
  • АТОЛ, руководство или документация производителя
  • ФНС России, документы и разъяснения по ККТ