Fiscal receipts compliance with Russian Federation regulations

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

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

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

В платежной платформе Monetix формирование фискальных чеков с использованием сервисов «АТОЛ Онлайн» или Orange Data возможно при разовой и повторяемой оплате, выплате и возврате. Данные для формирования фискального чека передаются в виде JSON-объекта в запросах на выполнение операций sale, auth, capture, refund, reversal, recurring и payout. После успешного выполнения операции пользователю направляется фискальный чек, а веб-сервису мерчанта направляются два оповещения: оповещение с информацией о выполненной операции и оповещение с данными фискального чека.

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

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

Особенности использования сервиса Orange Data

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

Особенности использования сервиса «АТОЛ Онлайн»

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

• Если по каким-либо причинам чек не был сформирован после успешного проведения платежа, можно отправить запрос на выполнение операции по созданию фискального чека повторно. Для этого отправляется запрос к конечной точке /v2/cash-voucher/recreate с обязательным указанием JSON-объектов general и object_info (подробнее о параметрах, передаваемых в этом запросе — в разделе Формат запроса для повторного создания чека). Если в запросе на проведение платежа мерчант не передал данные для формирования фискального чека, их необходимо отправить в запросе на выполнение операции повторного создания фискального чека. В противном случае операция создания чека отклоняется.

  Следует помнить, что в соответствии с законом 54-ФЗ чек необходимо отправить в течение одного расчетного дня (24 часа) с момента поступления денежных средств на счет мерчанта. Если с этого момента прошло более 24 часов, запрос на повторное формирование фискального чека отправлять не следует. Вместо этого мерчанту необходимо сформировать чек коррекции в личном кабинете сервиса.

• Сервис поддерживает возможность аннулирования фискального чека. Чтобы аннулировать фискальный чек, необходимо обратиться к специалистам технической поддержки support@monetix.pro.

Формат данных для формирования чека

Данные для формирования фискального чека передаются в объекте cash_voucher_data. Структура объекта приведена в схеме CashVoucherData в спецификации Gate 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 — сумма оплаты.

В представленном далее примере запроса на проведение оплаты в объекте cash_voucher_data содержится список из двух товарных позиций в массиве positions.

{
  "general": {
    "project_id": 92724,
    "payment_id": "CSMSHP-7654321-778",
    "signature": "5fgffgFxFLYGsBgremiffddgYuezUf+6VWlrssH+LysUfdQM+w=="
  },
  "customer": {
    "ip_address": "84.47.129.12"
  },
  "payment": {
    "amount": 105000,
    "currency": "RUB"
  },
  "card": {
    "pan": "1122334455667788",
    "year": 2024,
    "month": 10,
    "card_holder": "JOHN DOE",
    "cvv": "517"
  },
  "cash_voucher_data": {
    "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
      }
    ]
  }
}

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

"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"
}

Формат запроса на повторное создание чека

При формировании запросов на повторное создание фискального чека необходимо учитывать следующее:

1. POST-запрос должен отправляться к конечной точке /v2/cash-voucher/recreate.
2. В запросе должны использоваться следующие объекты и параметры:
   • • general — объект, содержащий основные идентификационные сведения запроса:
       • project_id — идентификатор проекта, полученный от Monetix при интеграции;
       • payment_id — идентификатор платежа, уникальный в рамках проекта мерчанта;
       • signature — подпись запроса, составленная после указания целевых параметров;
     • object_info — объект c идентификатором операции operation_id, созданной в рамках выполнения запроса на проведение платежа.
3. Если в запросе на проведение платежа, для которого необходимо сформировать фискальный чек, не были переданы фискальные данные или требуется отправить уточненные фискальные данные, они должны быть переданы в объекте cash_voucher_data.

Далее представлен пример тела запроса на повторное формирование фискального чека после успешного проведения одностадийной оплаты с указанием идентификатора операции sale, созданной в рамках выполнения запроса на оплату.

{
    "general": {
        "project_id": 92724,
        "payment_id": "CSMSHP-7654321-778",
        "signature": "5fgsjhgfgFxO9UaFLYGsBgremiffddgYuezUf+6VWlrsdfsH+LysUfdQM+w=="
    },
    "object_info": {
        "operation_id": 81727121126762   \\ Идентификатор операции sale
    }
}

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

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