Описание протокола ЕКАМ Онлайн

ЕКАМ Онлайн — это сервис, который позволяет формировать фискальные чеки из бэк-офиса любой CMS, CRM и учётной системы по открытому API в полном соответствии с 54-ФЗ.

Назначение сервиса

Согласно новой редакции Федерального закона от 22.05.2003 № 54–ФЗ все интернет-магазины и онлайн-сервисы в России с 01.07.2017 должны применять ККТ независимо от способы оплаты. Поэтому появилась необходимость в сервисе, который бы решал две задачи:

  • Формировать фискальные чеки в момент онлайн-оплаты автоматически (кейс "клиент оплатил онлайн")
  • Печатать кассовые чеки из бэк-офиса магазина вручную (кейс "клиент пришел в магазин и оплатил на месте")

Отличительные особенности:

  • Возможность работы нескольких интернет-магазинов и стационарной точки продаж на одной ККТ
  • Автоматическая и ручная печать чеков из бэк-офиса любой внешней системы по API
  • Гибкий выбор: бумажный чек, электронный чек или оба сразу
  • Балансировка нагрузки на фискальные накопители и ККТ.
  • Умная система мониторинга, отслеживающая сбои, аномальные нагрузки и другие факторы.
  • Экономичное решение с абонентской платой от 800 руб. в месяц

Оборудование

Магазин покупает необходимое количество комплектов оборудования ИНТЕРНЕТ-МАГАЗИН, рекомендуемое число можно уточнить в клиентском отделе ЕКАМ. В комплект входит:

  • ККТ АТОЛ 30Ф
  • Микрокомпьютер EKAM-BOX
  • 1 месяц использования сервиса ЕКАМ Онлайн

С сервисом будет работать любая ККТ из поддерживаемых. Купить оборудование можно в любом месте.

Использование сервиса

В платформе ЕКАМ есть сущность торговая точка, она может быть трёх видов:

  • Стационарная точка
  • Курьер
  • Интернет-касса

Работа со стационарной точкой или курьером происходит с помощью мобильного приложения ЕКАМ Касса на платформе Android. Интернет-касса — это основная сущность сервиса ЕКАМ Онлайн, для неё Android-устройство не требуется. По сути это конкретный интернет-магазин, для которого формируются фискальные чеки. На текущий момент у магазина может быть 1 юридическое лицо (скоро будет поддержка нескольких юридических лиц), а у юридического лица может быть несколько интернет-касс.

Для каждой интернет-кассы указываются микрокомпьютеры EKAM-BOX, которые будут ее обслуживать. ККТ подключаются к EKAM-BOX по USB (1 ККТ = EKAM-BOX). Для каждой интернет-кассы формируется своя очередь чеков, из которой чеки распределяются на ККТ, подключенные к этой интернет-кассе через обслуживающие её микрокомпьютеры EKAM-BOX. Чем больше у магазина интернет-касс и ККТ, тем больше абонентская плата.

Чеки от магазина по API поступают на облако ЕКАМ Онлайн. Веб-сервис записывает их в очередь соответствующей интернет-кассы. Очередь играет роль буфера и увеличивается в размере, если оборудование не подключено или не справляется с нагрузкой. Увеличение количества ККТ приводит к увеличению скорости обработки чеков, что приводит к уменьшению очереди и задержек формирования чеков.

Результат запроса на чек можно проверить по API или в бэк-офисе ЕКАМ.

Смены ККТ открываются автоматическо с первым чеком смены. Смены ККТ закрываются по запросу через API, по настроенному расписанию раз в сутки и автоматически, когда нужно напечатать чек, а смена длится больше 24 часов.

Подключение к сервису

  1. Разработчик интеграционного приложения обращается в техподдержку ЕКАМ (support@ekam.ru), сообщает о желании создать приложение, предоставляет свои контакты и данные о системе, с которой планирует произвести интеграцию.
  2. Техподдержка сообщает разработчику 2 параметра: Client ID и Client Secret Key.
  3. Разработчик создаёт установщик приложения, который будет создавать шлюз для работы с конкретной интернет-кассой. Это происходит по протоколу OAuth2. Для этого нужно перенаправить пользователя на адрес
    https://app.ekam.ru/oauth?auth_params[client_id]={<Client ID>}&auth_params[redirect_url]={<Redirect URL>}&state={<State>}
    • <Client ID> — полученный от техподдержки ЕКАМ параметр Client ID.
    • <Redirect URL> — адрес, на который пользователь будет перенаправлен после успешной установки приложения.
    • <State> — случайно сгенерированная строка (например, в base64). Используется для проверки безопасности на разных этапах.

Алгоритм взаимодействия с сервисом



 

 

Заказ в один клик