Фискализация чеков по 54-ФЗ для онлайн-оплат
Фискализация чеков - это регистрация кассового чека по онлайн-оплате: чек формирует облачная касса, а данные через ОФД уходят в ФНС. В АТОЛ Pay это делает АТОЛ Онлайн: передайте блок receipt в запросе платежа, и чек «Приход» уйдет после оплаты. Для предоплаты и зачета аванса, маркировки и чеков коррекции подключите API АТОЛ Онлайн v5 напрямую.
- Чек «Приход» после оплаты
- Чек возврата - при возврате
- ФФД 1.2 и маркировка через API v5
Простыми словами
Какой чек нужен при онлайн-оплате
Кассовый чек по 54-ФЗ нужен и при оплате на сайте. Если товар или услуга передаются сразу, хватит одного чека «Приход» в момент оплаты. Если товар передают позже, чеков два: чек предоплаты при оплате и чек полного расчета с зачетом аванса при передаче.
- Момент чека
- Автоматический чек в платежеСтрого в момент оплаты
- Прямая интеграция с АТОЛ ОнлайнЛюбой: при оплате, отгрузке или выдаче товара
- Чеков на заказ
- Автоматический чек в платежеОдин чек «Приход» и автоматический чек возврата
- Прямая интеграция с АТОЛ ОнлайнСколько требует 54-ФЗ: предоплата, зачет аванса, частичные отгрузки
- Маркировка
- Автоматический чек в платежеНе передается
- Прямая интеграция с АТОЛ ОнлайнКоды маркировки в позиции чека по ФФД 1.2 (mark_code)
- Агентские схемы
- Автоматический чек в платежеБазовые: агент и поставщик из личного кабинета
- Прямая интеграция с АТОЛ ОнлайнПолные реквизиты agent_info и supplier_info
- Чеки коррекции
- Автоматический чек в платежеНе формируются
- Прямая интеграция с АТОЛ ОнлайнКоррекция прихода, расхода и их возвратов
| Параметр | Автоматический чек в платеже | Прямая интеграция с АТОЛ Онлайн |
|---|---|---|
| Момент чека | Строго в момент оплаты | Любой: при оплате, отгрузке или выдаче товара |
| Чеков на заказ | Один чек «Приход» и автоматический чек возврата | Сколько требует 54-ФЗ: предоплата, зачет аванса, частичные отгрузки |
| Маркировка | Не передается | Коды маркировки в позиции чека по ФФД 1.2 (mark_code) |
| Агентские схемы | Базовые: агент и поставщик из личного кабинета | Полные реквизиты agent_info и supplier_info |
| Чеки коррекции | Не формируются | Коррекция прихода, расхода и их возвратов |
Автоматический чек
Как чек проходит путь от оплаты до ОФД
Так работает вариант А: отдельный запрос к кассе не нужен, а о результате ваш сервер узнает из уведомления.
- Шаг 1receipt
Платеж с чеком
Ваш сервер регистрирует платеж и добавляет блок receipt: позиции, систему налогообложения и providerId 100 - АТОЛ Онлайн.
- Шаг 2
Оплата
Покупатель платит на платежной странице. Чек уйдет на email из buyer.email, а если его нет - на email, указанный при оплате.
- Шаг 3sell
Чек «Приход»
После успешной оплаты АТОЛ Pay отправляет чек в облачную кассу АТОЛ Онлайн. Касса регистрирует его, данные уходят в ФНС через ОФД.
- Шаг 4fiscal
Уведомление о чеке
На notificationUrl приходит type=fiscal с receiptId. Если чек не отправился, платеж не отменяется: причина - в errorCode и errorMessage.
- Шаг 5sell_refund
Возврат
При отмене или возврате платежа с чеком АТОЛ Pay сам отправляет чек возврата прихода и уведомление с receiptType sell_refund.
Две схемы
Чек в платеже или прямая интеграция с кассой
В обоих вариантах деньги принимает АТОЛ Pay. Выбор зависит от того, когда по 54-ФЗ должен формироваться чек.
Вариант А · одна интеграция
Чек уходит вместе с оплатой
Для товаров и услуг, которые покупатель получает сразу: цифровые товары, билеты, донаты.
- Блок receipt в запросе регистрации платежа
- Чек «Приход» - после успешной оплаты
- Чек «Возврат прихода» - при отмене или возврате
- Агент и поставщик - по ID из личного кабинета
POST /v1/ecom/payments · receipt.providerId: 100
Вариант Б · две интеграции
Чеки пробивает ваш бэкенд
АТОЛ Pay принимает деньги, а чеки вы отправляете в АТОЛ Онлайн v5 - когда нужно и сколько нужно.
- Чек предоплаты при оплате и полный расчет с зачетом аванса при передаче
- Маркировка в чеке по ФФД 1.2 и результат проверки кода
- Полные агентские реквизиты agent_info и supplier_info
- Чеки коррекции - самостоятельные и по предписанию ФНС
POST /possystem/v5/{group_code}/{operation}
Агентская схема - АТОЛ Чеки
Чек по оплатам через АТОЛ Pay формирует касса платежного агента: с признаком агента и вашими реквизитами поставщика. Комиссия - 1,5 % за чек при успешном платеже.
Словарь
Какие чеки встречаются в онлайн-продажах
Коротко о документах и терминах, которые понадобятся, чтобы выбрать схему и правильно заполнить чек.
Чек «Приход»
Основной чек при оплате покупателем. В варианте А уходит автоматически, в варианте Б - операция sell.
Чек возврата прихода
Пробивается, когда деньги возвращают покупателю. Для платежа с receipt АТОЛ Pay формирует его сам, в API v5 - операция sell_refund.
Чек предоплаты
Нужен, если покупатель платит сейчас, а товар получит позже. В позиции указывают признак способа расчета «Предоплата 100%».
Пример магазина с доставкойЗачет аванса
При передаче оплаченного товара пробивают чек «Полный расчет». Внесенный аванс отражают видом оплаты 2 - «предварительная оплата, зачет аванса».
Чек коррекции
Исправляет расчет, проведенный без кассы или с ошибкой. Тип self - ошибку нашли вы, instruction - коррекция по предписанию ФНС.
Чеки коррекции в документацииМаркировка в чеке
Код маркировки передают в позиции чека по ФФД 1.2. Результат проверки кода возвращается в marks_result, значение 15 - проверка пройдена.
Поля маркировкиРазработчикам
Чек в платеже - один блок receipt
Передайте позиции, систему налогообложения и провайдера в запросе регистрации платежа. Значения для полей чека, агентов и поставщиков отдают отдельные методы.
- POST /v1/ecom/payments
- Зарегистрировать платеж с блоком receipt
- GET /v1/ecom/receipts/dictionaries
- Получить ставки НДС, способы расчета, единицы измерения и СНО
- GET /v1/ecom/receipts/agents
- Получить агентов из личного кабинета
- GET /v1/ecom/receipts/suppliers
- Получить поставщиков из личного кабинета
- POST /possystem/v5/{group_code}/{operation}
- Прямая интеграция: приход, возврат и чеки коррекции в АТОЛ Онлайн v5
{
"amount": 449000,
"orderId": "order-1024",
"sessionType": "oneStep",
"additionalProps": {
"returnUrl": "https://example.com/order/return",
"notificationUrl": "https://example.com/atolpay/callback"
},
"receipt": {
"buyer": { "email": "client@example.com" },
"providerId": 100,
"type": "sell",
"sno": 1,
"positions": [
{
"name": "Онлайн-курс «Старт»",
"price": 299000,
"quantity": 1000,
"measure": 0,
"paymentMethod": 3,
"paymentSubject": 4,
"tax": 5
},
{
"name": "Консультация, 1 час",
"price": 150000,
"quantity": 1000,
"measure": 0,
"paymentMethod": 3,
"paymentSubject": 4,
"tax": 5
}
]
},
"paymentMethods": [{ "paymentType": "card", "bankId": 100 }]
}Подключение
Чеки по онлайн-оплатам за четыре шага
Касса для интернет-магазина здесь облачная: ККТ арендуется в АТОЛ Онлайн, покупать и обслуживать оборудование не нужно.
- 01
Подключите интернет-эквайринг
Зарегистрируйтесь в личном кабинете АТОЛ Pay и пройдите онбординг банка-партнера.
- 02
Настройте провайдера чеков
Укажите данные фискализации и версию ФФД в личном кабинете, раздел «Провайдер чеков».
- 03
Добавьте receipt в платежи
Передавайте позиции, sno и providerId 100. Агентов и поставщиков заведите в «Настройки > Настройки заказов».
- 04
Обрабатывайте уведомления о чеках
Сохраняйте receiptId и следите за status: fail - ошибка фискализации не отменяет оплату.
FAQ
При регистрации платежа вы передаете блок receipt с позициями заказа. После успешной оплаты АТОЛ Pay сам отправляет чек «Приход» в АТОЛ Онлайн (providerId 100), а при возврате - чек «Возврат прихода». Вы получаете уведомление type=fiscal с идентификатором чека.
Если покупатель платит сейчас, а товар получает позже, по 54-ФЗ это два фискальных события. В момент оплаты пробивают чек «Предоплата 100%», при передаче товара - чек «Полный расчет» с зачетом аванса: внесенную предоплату указывают видом оплаты 2 - «предварительная оплата, зачет аванса». Такие чеки ваш бэкенд отправляет напрямую в АТОЛ Онлайн v5, а платеж в АТОЛ Pay регистрируют без блока receipt.
Если платеж зарегистрирован с блоком receipt, при его отмене или возврате АТОЛ Pay сам отправляет в АТОЛ Онлайн чек «Возврат прихода» и присылает уведомление type=fiscal с receiptType sell_refund. При прямой интеграции чек возврата прихода пробивают операцией sell_refund: сумма равна возвращаемым позициям, а вид оплаты - тот же, которым платил покупатель.
Чек коррекции исправляет расчет, проведенный без кассы или с ошибкой, например если чек не пробился при сбое. В АТОЛ Онлайн v5 его регистрируют операциями sell_correction, buy_correction и их возвратами, а в correction_info указывают тип: self - ошибку нашли вы, instruction - коррекция по предписанию налогового органа. По платежу с блоком receipt АТОЛ Pay чеки коррекции не формирует, они доступны только в прямой интеграции.
Коды маркировки передают по ФФД 1.2 в прямой интеграции с АТОЛ Онлайн v5 - в блоке receipt платежа АТОЛ Pay их нет. В позиции указывают payment_object 33 (маркируемый товар с кодом маркировки), mark_processing_mode "0", planned_status и объект mark_code; код gs1m передают целиком в Base64. Результат проверки приходит в marks_result: значение 15 означает, что проверка пройдена.
Оплата не отменяется: если платеж прошел, а при фискализации возникла ошибка, транзакция все равно проведена. Результат приходит в уведомлении type=fiscal - при status: fail в нем есть errorCode и errorMessage. Отслеживайте такие уведомления: по ним видно, по каким заказам чек не сформирован.
Облачная касса - онлайн-касса, которая работает в дата-центре оператора: чеки по интернет-оплатам формируются и передаются в ОФД без оборудования в офисе. Для платежей через АТОЛ Pay эту роль выполняет АТОЛ Онлайн - касса арендуется в сервисе, а чек уходит автоматически после оплаты.
АТОЛ Онлайн v5 работает по ФФД 1.2. Версия ФФД и данные фискализации настраиваются в личном кабинете АТОЛ Pay в разделе «Провайдер чеков».
Если между оплатой и передачей товара проходит время (чек предоплаты и чек зачета аванса), нужна маркировка (ФФД 1.2, mark_code), полные агентские схемы или чеки коррекции - фискализируйте напрямую через API АТОЛ Онлайн v5, а АТОЛ Pay используйте только для приема денег.
Фискализация чеков - коротко
Фискализация чеков в АТОЛ Pay не требует отдельной кассовой интеграции: чек по 54-ФЗ формирует облачная касса АТОЛ Онлайн в момент оплаты, а при возврате - чек «Возврат прихода». Для предоплаты, зачета аванса и маркировки подключается прямая интеграция с API v5.
- ФФД 1.2 и коды маркировки
- Автоматические чеки прихода и возврата
- Мониторинг касс и фискальных накопителей
Читайте также: Как работает облачная касса, Фискализация онлайн-платежей: как выбрать схему, АТОЛ Чеки - агентский чек, Эквайринг для интернет-магазина
Смотрите также
Подключение АТОЛ Pay
Оставьте заявку - поможем подключить эквайринг и выбрать схему фискализации под ваши заказы.