Fiscal receipts compliance with Russian Federation regulations

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

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

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

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

Общие особенности

• Настройка срока ожидания чека на стороне Monetix выполняется в зависимости от условий предоставления сервиса. Эти данные необходимо предоставить при подключении сервиса на стороне Monetix.
• Следует иметь ввиду ограничения кодировки передаваемых строк. Фискальные данные передаются в фискальный накопитель в кодировке CP866, которая поддерживает меньший набор символов, чем кодировка UTF-8. Например, в CP866 отсутствуют символы кавычек («»), поэтому они не передаются в фискальный накопитель. Соответственно, наименование товара Сок «Груша» в фискальном чеке передается как Сок Груша.
• При использовании онлайн-касс не осуществляется проверка полученных данных на соответствие форматам фискальных документов (ФФД), утвержденных ФНС России. Например, согласно ФФД телефон покупателя имеет формат +{Ц}, где Ц — это атрибут, обозначающий, что данные реквизита должны быть представлены в виде цифры, а электронный адрес имеет формат {С}@{C}, где С — это атрибут, обозначающий, что данные реквизита должны быть представлены в виде символа. Однако онлайн-кассы принимают любую строку длиной от 1 до 64 символов. Также в онлайн-кассах не выполняется проверка на корректное использование тегов (в том числе реквизита «данные агента»), поэтому мерчантам необходимо ознакомиться с документацией о ФФД, предоставляемой ФНС (документ Форматы фискальных документов, обязательных к использованию), и внимательно следить за использованием тегов в зависимости от конкретного сценария работы.
• В настоящее время сервисы «АТОЛ Онлайн» и Orange Data работают с использованием ФФД 1.05.
• В платежной платформе Monetix не выполняется формирование чека коррекции. Такие чеки мерчанту необходимо формировать самостоятельно в личном кабинете сервиса.
• В платежной платформе Monetix не выполняется формирование штрих-кода или 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": "johndoe@example.com",
  "positions": [
    {
      "quantity": 1,
      "tax": 1,
      "position_description": "DaVinchi Book",
      "payment_method_type": 4,
      "payment_subject_type": 1,
      "price": 25000
    },
    {
      "quantity": 2,
      "tax": 1,
      "position_description": "Bottle of Slurm",
      "payment_method_type": 4,
      "payment_subject_type": 1,
      "price": 40000
    }
  ],
  "payments": [
    {
      "payment_type": 2,
      "amount": 105000
    }
  ]
}

ewogICAgInNlbmRfY2FzaF92b3VjaGVyIjp0cnVlLAogICAgImlubiI6IjUwNTAwOTE3MTkiLAogICAgImdyb3VwIjoibWFpbl8xMjA0IiwKICAgICJ0YXhhdGlvbl9zeXN0ZW0iOjAsCiAgICAiZW1haWwiOiJjY2lvbGtvd3NraUBnbWFpbC5jb20iLAogICAgInBvc2l0aW9ucyI6WwogICAgICB7CiAgICAgICAgInF1YW50aXR5IjoxLAogICAgICAgICJ0YXgiOjEsCiAgICAgICAgInBvc2l0aW9uX2Rlc2NyaXB0aW9uIjoi0JrQvdC40LPQsCDQndCwINCb0YPQvdC1IiwKICAgICAgICAicGF5bWVudF9tZXRob2RfdHlwZSI6NCwKICAgICAgICAicGF5bWVudF9zdWJqZWN0X3R5cGUiOjEsCiAgICAgICAgInByaWNlIjoyNTAwMAogICAgICB9LAogICAgICB7CiAgICAgICAgInF1YW50aXR5IjoyLAogICAgICAgICJ0YXgiOjEsCiAgICAgICAgInBvc2l0aW9uX2Rlc2NyaXB0aW9uIjoi0JzQvtC00LXQu9GMINCw0Y3RgNC-0YHRgtCw0YLQsCIsCiAgICAgICAgInBheW1lbnRfbWV0aG9kX3R5cGUiOjQsCiAgICAgICAgInBheW1lbnRfc3ViamVjdF90eXBlIjoxLAogICAgICAgICJwcmljZSI6NDAwMDAKICAgICAgfQogICAgXSwKICAgICJwYXltZW50cyI6WwogICAgICB7CiAgICAgICAgInBheW1lbnRfdHlwZSI6MiwKICAgICAgICAiYW1vdW50IjoxMDUwMDAKICAgICAgfQogICBdCn0

https://paymentpage.trxhost.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, необходимо знать расшифровку их численных значений. Это параметры, в которых содержится информация о реквизитах фискальных документов согласно требованиям ФНС.

При передаче значений 15 или 16 в параметре payment_subject_type мерчанту необходимо передать численное значение в параметре position_description. Если передается значение 15 (внереализационный доход), то параметр position_description должен принимать численное значение от 1 до 25. Если передается значение 16 (страховые взносы), то параметр position_description должен принимать численное значение от 26 до 31. Подробная информация о расшифровке этих значений представлена в таблице «Наименование предмета расчета».