Перейти к содержимому

Общий алгоритм взаимодействия

Пошаговый алгоритм работы с API АТОЛ Онлайн - регистрация в ЛК, получение токена, отправка чека и получение результата.

Зарегистрируйтесь и получите учетные данные

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

Тестовая среда

Отлаживать интеграцию можно без собственных касс: АТОЛ публикует демо-доступ к тестовому контуру https://testonline.atol.ru/possystem/v5/. Протокол, структура ответов и коды ошибок там те же, что и в боевой среде, а чеки не уходят в ОФД. Тот же логин и пароль подходят к тестовому контуру сервиса информации о ККТ и ФН - https://testonline.atol.ru/api.

Получите токен авторизации

Запросите токен методом getToken. Токен действует 24 часа и передается во все методы API в заголовке Token.

Отправьте чек на регистрацию

Отправьте POST-запрос регистрации документа на https://online.atol.ru/possystem/v5/<group_code>/<operation>. При корректном запросе сервис вернет уникальный идентификатор документа (uuid) и статус wait.

Получите результат обработки

Два способа:

  • Callback: если в запросе регистрации указан service.callback_url, сервис по результатам обработки чека отправит POST-запрос на этот URL.
  • Опрос: если callback_url не указан или запрос не пришел в течение 300 секунд, запросите результат самостоятельно - GET /{group_code}/report/{uuid}.

Sequence-диаграмма

Загрузка диаграммы…