Общий алгоритм взаимодействия
Пошаговый алгоритм работы с 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}.