Обзор АТОЛ Онлайн v5
Сервис удаленной фискализации чеков на арендованных ККТ по протоколу v5 (ФФД 1.2) - назначение, устройство и основные методы.
Справочник к шагам 3–4
Раздел нужен, если на шаге 2 вы выбрали свою фискализацию. По пути интеграции эти страницы читает ассистент; если пишете код сами - начните с общего алгоритма и примеров.
АТОЛ Онлайн - сервис удаленной регистрации (фискализации) чеков на арендованных клиентом кассах (ККТ) через клиентский API. Версия сервиса v5 поддерживает регистрацию чеков формата фискальных данных версии 1.2 (ФФД 1.2) согласно приказу ФНС России от 14.09.2020 № ЕД-7-20/662@.
Как устроен сервис
При регистрации в сервисе клиент добавляет юридическое лицо/ИП и прикрепляет к нему интернет-магазины. У клиента может быть несколько юрлиц/ИП, а юрлицо - несколько интернет-магазинов.
Для каждого интернет-магазина в ФНС регистрируется необходимое количество ККТ
(сервис помогает рассчитать рекомендуемое количество). Все зарегистрированные
ККТ магазина объединяются в группу ККТ с кодом группы (group_code). Для
каждого магазина формируется своя очередь чеков, из которой чеки
распределяются на ККТ, входящие в группу.
Методы API
Базовый URL боевой среды: https://online.atol.ru/possystem/v5/
Тестовая среда: https://testonline.atol.ru/possystem/v5/ - учетные данные
демо-доступа публикуются на сайте АТОЛ; протокол и структура ответов те же.
| Метод | Назначение |
|---|---|
POST/GET /getToken | Авторизация пользователя - токен на 24 часа |
POST /{group_code}/{operation} | Регистрация документа - 8 типов операций (sell, sell_refund, buy, buy_refund и 4 коррекции) |
GET /{group_code}/report/{uuid} | Получение результата обработки документа |
Разделы
Как начать: ЛК, учетные данные, токен, отправка чека, получение результата.
Регистрация документаПолное описание запроса: receipt, client, company, items, payments, vats и маркировка.
Чеки коррекцииКоррекция прихода/расхода и их возвратов, correction_info.
ОшибкиОшибки сервиса и ошибки при работе с ККТ.