Перейти к содержимому
Чеки по 54-ФЗ

Фискализация чеков по 54-ФЗ для онлайн-оплат

Фискализация чеков - это регистрация кассового чека по онлайн-оплате: чек формирует облачная касса, а данные через ОФД уходят в ФНС. В АТОЛ Pay это делает АТОЛ Онлайн: передайте блок receipt в запросе платежа, и чек «Приход» уйдет после оплаты. Для предоплаты и зачета аванса, маркировки и чеков коррекции подключите API АТОЛ Онлайн v5 напрямую.

  • Чек «Приход» после оплаты
  • Чек возврата - при возврате
  • ФФД 1.2 и маркировка через API v5

Простыми словами

Какой чек нужен при онлайн-оплате

Кассовый чек по 54-ФЗ нужен и при оплате на сайте. Если товар или услуга передаются сразу, хватит одного чека «Приход» в момент оплаты. Если товар передают позже, чеков два: чек предоплаты при оплате и чек полного расчета с зачетом аванса при передаче.

Момент чека
Автоматический чек в платежеСтрого в момент оплаты
Прямая интеграция с АТОЛ ОнлайнЛюбой: при оплате, отгрузке или выдаче товара
Чеков на заказ
Автоматический чек в платежеОдин чек «Приход» и автоматический чек возврата
Прямая интеграция с АТОЛ ОнлайнСколько требует 54-ФЗ: предоплата, зачет аванса, частичные отгрузки
Маркировка
Автоматический чек в платежеНе передается
Прямая интеграция с АТОЛ ОнлайнКоды маркировки в позиции чека по ФФД 1.2 (mark_code)
Агентские схемы
Автоматический чек в платежеБазовые: агент и поставщик из личного кабинета
Прямая интеграция с АТОЛ ОнлайнПолные реквизиты agent_info и supplier_info
Чеки коррекции
Автоматический чек в платежеНе формируются
Прямая интеграция с АТОЛ ОнлайнКоррекция прихода, расхода и их возвратов

Автоматический чек

Как чек проходит путь от оплаты до ОФД

Так работает вариант А: отдельный запрос к кассе не нужен, а о результате ваш сервер узнает из уведомления.

  1. Шаг 1receipt

    Платеж с чеком

    Ваш сервер регистрирует платеж и добавляет блок receipt: позиции, систему налогообложения и providerId 100 - АТОЛ Онлайн.

  2. Шаг 2

    Оплата

    Покупатель платит на платежной странице. Чек уйдет на email из buyer.email, а если его нет - на email, указанный при оплате.

  3. Шаг 3sell

    Чек «Приход»

    После успешной оплаты АТОЛ Pay отправляет чек в облачную кассу АТОЛ Онлайн. Касса регистрирует его, данные уходят в ФНС через ОФД.

  4. Шаг 4fiscal

    Уведомление о чеке

    На notificationUrl приходит type=fiscal с receiptId. Если чек не отправился, платеж не отменяется: причина - в errorCode и errorMessage.

  5. Шаг 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
Блок receipt в документации
POST /v1/ecom/payments
{
  "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 }]
}

Подключение

Чеки по онлайн-оплатам за четыре шага

Касса для интернет-магазина здесь облачная: ККТ арендуется в АТОЛ Онлайн, покупать и обслуживать оборудование не нужно.

Открыть документацию
  1. 01

    Подключите интернет-эквайринг

    Зарегистрируйтесь в личном кабинете АТОЛ Pay и пройдите онбординг банка-партнера.

  2. 02

    Настройте провайдера чеков

    Укажите данные фискализации и версию ФФД в личном кабинете, раздел «Провайдер чеков».

  3. 03

    Добавьте receipt в платежи

    Передавайте позиции, sno и providerId 100. Агентов и поставщиков заведите в «Настройки > Настройки заказов».

  4. 04

    Обрабатывайте уведомления о чеках

    Сохраняйте receiptId и следите за status: fail - ошибка фискализации не отменяет оплату.

FAQ

Вопросы о фискализации чеков

Фискализация чеков - коротко

Фискализация чеков в АТОЛ Pay не требует отдельной кассовой интеграции: чек по 54-ФЗ формирует облачная касса АТОЛ Онлайн в момент оплаты, а при возврате - чек «Возврат прихода». Для предоплаты, зачета аванса и маркировки подключается прямая интеграция с API v5.

  • ФФД 1.2 и коды маркировки
  • Автоматические чеки прихода и возврата
  • Мониторинг касс и фискальных накопителей

Читайте также: Как работает облачная касса, Фискализация онлайн-платежей: как выбрать схему, АТОЛ Чеки - агентский чек, Эквайринг для интернет-магазина

Подключение АТОЛ Pay

Настройте чеки вместе с приемом оплаты

Оставьте заявку - поможем подключить эквайринг и выбрать схему фискализации под ваши заказы.