Работа с фискальными чеками РФ

Общая информация

В соответствии с законодательством Российской Федерации всем организациям и большинству индивидуальных предпринимателей при осуществлении расчётов с использованием электронных средств платежа необходимо применять контрольно-кассовую технику (ККТ) и информировать Федеральную налоговую службу (ФНС) о совершённых платежах. Передача данных регулируется Федеральным законом РФ от 22.05.2003 № 54-ФЗ «О применении контрольно-кассовой техники при осуществлении расчётов в Российской Федерации».

ecommpay предоставляет мерчантам возможность работать с фискальными чеками с использованием сервисов «АТОЛ Онлайн» или Orange Data. Для подключения сервиса мерчанту необходимо заключить отдельный договор с компанией-поставщиком услуги, а также получить доступ в личный кабинет на сайте компании. Подробную информацию о подключении следует уточнять у курирующего менеджера ecommpay.

В платёжной платформе ecommpay формирование фискальных чеков с использованием сервисов «АТОЛ Онлайн» или Orange Data возможно при проведении разовых и повторяемых оплат через Payment Page. Данные для формирования фискального чека передаются в виде JSON-объекта, закодированного с использованием алгоритма Base64, в запросах на открытие платёжной формы. После успешного проведения платежа пользователю отправляется фискальный чек, а веб-сервису мерчанта отправляются два оповещения — оповещение с информацией о результате проведения платежа и оповещение с данными фискального чека.

Особенности работы

Общие

• Настройка срока ожидания чека на стороне ecommpay выполняется в зависимости от условий предоставления сервиса. Эти данные необходимо предоставить при подключении сервиса на стороне ecommpay.
• Следует иметь ввиду ограничения кодировки передаваемых строк. Фискальные данные передаются в фискальный накопитель в кодировке CP866, которая поддерживает меньший набор символов, чем кодировка UTF-8. Например, в CP866 отсутствуют символы кавычек («»), поэтому они не передаются в фискальный накопитель. Соответственно, наименование товара Сок «Груша» в фискальном чеке передаётся как Сок Груша.
• При использовании онлайн-касс не осуществляется проверка полученных данных на соответствие форматам фискальных документов (ФФД), утверждённых ФНС России. Например, согласно ФФД телефон покупателя имеет формат +{Ц}, где Ц — это атрибут, обозначающий, что данные реквизита должны быть представлены в виде цифры, а электронный адрес имеет формат {С}@{C}, где С — это атрибут, обозначающий, что данные реквизита должны быть представлены в виде символа. Однако онлайн-кассы принимают любую строку длиной от 1 до 64 символов. Также в онлайн-кассах не выполняется проверка на корректное использование тегов (в том числе реквизита «данные агента»), поэтому мерчантам необходимо ознакомиться с документацией о ФФД, предоставляемой ФНС (документ Форматы фискальных документов, обязательных к использованию), и внимательно следить за использованием тегов в зависимости от конкретного сценария работы.
• В настоящее время сервисы «АТОЛ Онлайн» и Orange Data работают с использованием ФФД 1.05.
• В платёжной платформе ecommpay не выполняется формирование чека коррекции. Такие чеки мерчанту необходимо формировать самостоятельно в личном кабинете сервиса.
• В платёжной платформе ecommpay не выполняется формирование штрих-кода или QR-кода.

Особенности работы с сервисом Orange Data

• Максимальная сумма для одной позиции и максимальная сумма всех позиций составляет 99 999 999,99 рублей. Максимальное количество предмета расчёта — 281 474 976,710655.
• При проведении оплаты с предварительной блокировкой средств отправка чека выполняется после подтверждения оплаты в результате списания блокированных средств. При этом данные для формирования фискального чека можно передавать только в запросе на открытие Payment Page для выполнения блокировки средств.

Особенности работы с сервисом «АТОЛ Онлайн»

• Максимальная сумма для одной позиции и максимальная сумма всех позиций составляет 42 949 672,95 рублей.
• При проведении оплаты с предварительной блокировкой средств отправка чека выполняется после подтверждения оплаты в результате списания блокированных средств. При этом данные для формирования фискального чека можно передавать как в запросе на открытие Payment Page для выполнения блокировки средств, так и в запросе на выполнение списания заблокированных средств (с использованием интерфейса Gate). Если данные не переданы ни в одном из запросов, то операция создания чека отклоняется. В случае изменения суммы оплаты уточнённые данные для формирования фискального чека следует обязательно передать в запросе на выполнение списания заблокированных средств, чтобы операция создания чека не была отклонена.
• При работе с сервисом необходимо обеспечить передачу необязательного параметра payment_address, содержащего сведения о реквизите «место расчётов». Значение параметра можно указать либо при подключении возможности работы с фискальными чеками в платёжной платформе, либо передавать в запросах.

Формат данных

Данные для формирования фискального чека передаются в объекте cash_voucher_data. Этот объект кодируется в строку с использованием алгоритма Base64 для URL. Затем кодированная строка передаётся в параметре cash_voucher_data в запросе на открытие Payment Page. Структура объекта приведена в модели CashVoucherData в спецификации API.

В объекте cash_voucher_data следующие параметры являются обязательными при работе с сервисами «АТОЛ Онлайн» и Orange Data:

• email — адрес электронной почты пользователя;
• inn — ИНН мерчанта;
• taxation_system — применяемая система налогообложения.

Параметр group, в котором передаётся наименование группы торговых устройств, используемых для выдачи фискального чека, является обязательным при работе с сервисом «АТОЛ Онлайн» и необязательным при работе с сервисом Orange Data.

Также в объекте передаются два массива:

• positions с перечислением товарных позиций чека. Параметры price для указания стоимости, position_description для описания товара или услуги и tax для определения ставки налога на добавленную стоимость являются обязательными. При работе с сервисом «АТОЛ Онлайн» параметр quantity для указания количества единиц товарной позиции является обязательным; при работе с сервисом Orange Data — необязательным.
• payments с указанием типа и суммы оплаты (в параметрах payment_type и amount).

Далее представлен пример преобразования JSON-объекта для последующей его передачи в параметре cash_voucher_data запроса на открытие Payment Page.

 {
    "send_cash_voucher":true,
    "inn":"5050091719",
    "group":"main_1204",
    "taxation_system":0,
    "email":"cciolkowski@gmail.com",
    "positions":[
      {
        "quantity":1,
        "tax":1,
        "position_description":"Книга На Луне",
        "payment_method_type":4,
        "payment_subject_type":1,
        "price":25000
      },
      {
        "quantity":2,
        "tax":1,
        "position_description":"Модель аэростата",
        "payment_method_type":4,
        "payment_subject_type":1,
        "price":40000
      }
    ],
    "payments":[
      {
        "payment_type":2,
        "amount":105000
      }
    ]
 }

ewogICAgInNlbmRfY2FzaF92b3VjaGVyIjp0cnVlLAogICAgImlubiI6IjUwNTAwOTE3MTkiLAogICAgImdyb3VwIjoibWFpbl8xMjA0IiwKICAgICJ0YXhhdGlvbl9zeXN0ZW0iOjAsCiAgICAiZW1haWwiOiJjY2lvbGtvd3NraUBnbWFpbC5jb20iLAogICAgInBvc2l0aW9ucyI6WwogICAgICB7CiAgICAgICAgInF1YW50aXR5IjoxLAogICAgICAgICJ0YXgiOjEsCiAgICAgICAgInBvc2l0aW9uX2Rlc2NyaXB0aW9uIjoi0JrQvdC40LPQsCDQndCwINCb0YPQvdC1IiwKICAgICAgICAicGF5bWVudF9tZXRob2RfdHlwZSI6NCwKICAgICAgICAicGF5bWVudF9zdWJqZWN0X3R5cGUiOjEsCiAgICAgICAgInByaWNlIjoyNTAwMAogICAgICB9LAogICAgICB7CiAgICAgICAgInF1YW50aXR5IjoyLAogICAgICAgICJ0YXgiOjEsCiAgICAgICAgInBvc2l0aW9uX2Rlc2NyaXB0aW9uIjoi0JzQvtC00LXQu9GMINCw0Y3RgNC-0YHRgtCw0YLQsCIsCiAgICAgICAgInBheW1lbnRfbWV0aG9kX3R5cGUiOjQsCiAgICAgICAgInBheW1lbnRfc3ViamVjdF90eXBlIjoxLAogICAgICAgICJwcmljZSI6NDAwMDAKICAgICAgfQogICAgXSwKICAgICJwYXltZW50cyI6WwogICAgICB7CiAgICAgICAgInBheW1lbnRfdHlwZSI6MiwKICAgICAgICAiYW1vdW50IjoxMDUwMDAKICAgICAgfQogICBdCn0

https://paymentpage.ecommpay.com/payment?payment_id=CSMSHP-7654321-778&payment_amount=105000&payment_currency=RUB&project_id=92724&payment_description=CSMSHP_7654321_778&region_code=ru&language_code=RU&force_payment_method=card&cash_voucher_data=ewogICAgInNlbmRfY2FzaF92b3VjaGVyIjp0cnVlLAogICAgImlubiI6IjUwNTAwOTE3MTkiLAogICAgImdyb3VwIjoibWFpbl8xMjA0IiwKICAgICJ0YXhhdGlvbl9zeXN0ZW0iOjAsCiAgICAiZW1haWwiOiJjY2lvbGtvd3NraUBnbWFpbC5jb20iLAogICAgInBvc2l0aW9ucyI6WwogICAgICB7CiAgICAgICAgInF1YW50aXR5IjoxLAogICAgICAgICJ0YXgiOjEsCiAgICAgICAgInBvc2l0aW9uX2Rlc2NyaXB0aW9uIjoi0JrQvdC40LPQsCDQndCwINCb0YPQvdC1IiwKICAgICAgICAicGF5bWVudF9tZXRob2RfdHlwZSI6NCwKICAgICAgICAicGF5bWVudF9zdWJqZWN0X3R5cGUiOjEsCiAgICAgICAgInByaWNlIjoyNTAwMAogICAgICB9LAogICAgICB7CiAgICAgICAgInF1YW50aXR5IjoyLAogICAgICAgICJ0YXgiOjEsCiAgICAgICAgInBvc2l0aW9uX2Rlc2NyaXB0aW9uIjoi0JzQvtC00LXQu9GMINCw0Y3RgNC-0YHRgtCw0YLQsCIsCiAgICAgICAgInBheW1lbnRfbWV0aG9kX3R5cGUiOjQsCiAgICAgICAgInBheW1lbnRfc3ViamVjdF90eXBlIjoxLAogICAgICAgICJwcmljZSI6NDAwMDAKICAgICAgfQogICAgXSwKICAgICJwYXltZW50cyI6WwogICAgICB7CiAgICAgICAgInBheW1lbnRfdHlwZSI6MiwKICAgICAgICAiYW1vdW50IjoxMDUwMDAKICAgICAgfQogICBdCn0

После успешного проведения оплаты информация о сформированном фискальном чеке передаётся мерчанту в отдельном оповещении. Также оповещение содержит ссылку на страницу платформы ОФД (оператора фискальных данных) со сформированным фискальным чеком. Далее представлен пример таких данных, переданных в оповещении.

 "cash_voucher_info": {
    "type": "cash_voucher_info",
    "device_rn": "00000000017190509",
    "fp": 164316,
    "document_number": 643,
    "document_index": 124,
    "fs_number": "9468906279",
    "fns_website": "www.nalog.ru",
    "processed_at": "2020-09-17T12:04:00+00:00",
    "shift_number": 138,
    "ofd_inn": "5551260691",
    "ofd_website": "https://lk.platformaofd.ru/web/noauth/cheque?fn=9468906279&fp=164316&i=643"
 }

Допустимые значения отдельных параметров

Для ряда параметров, передаваемых в объекте cash_voucher_data, необходимо знать расшифровку их численных значений. Это параметры, в которых содержится информация о реквизитах фискальных документов согласно требованиям ФНС.