Docs
API ЮKassa
Помощь
Подключить ЮKassa
Новый формат фискальных документов (ФФД 1.05)
1 января 2019 года вступило в силу дополнение к закону 54-ФЗ — введён новый формат фискальных документов (ФФД 1.05). В налоговую нужно отправлять два новых параметра:
  • признак предмета расчёта — это категория товаров и услуг, которые вы продаёте (например, товар, услуга или ставка в игре, признак предмета расчёта из приказа ФНС).
  • признак способа расчёта — это категория способа, которым вы принимаете оплату (например, оплата в кредит, предоплата или полный расчёт, признак способа расчёта из приказа ФНС).
Что нужно сделать
Если вы подключили наше решение для 54-ФЗ и передаёте данные для чека вместе с каждым платежом, добавьте к ним новые параметры.
Как это сделать — зависит от вашей онлайн-кассы и протокола, по которому вы работаете с ЮKassa.
Как настроить онлайн-кассу
АТОЛ Онлайн
  1. Сначала начните отправлять новые параметры вместе с платежом.
  2. Затем зайдите в личный кабинет АТОЛ и поменяйте ФФД. Как это сделать
Внимание. Обязательно в таком порядке: если вы сначала поменяете настройки в АТОЛ, может что-то сломаться: или платежи перестанут проходить, или ваша онлайн-касса не сможет сформировать чек.
Кит Инвест, Orange Data, МодульКасса и Бизнес.Ру Онлайн-Чеки**
Можно отправлять новые параметры.
Если вы их отправляете, ваша онлайн-касса всё правильно обработает.
Если не отправляете, подставит нужные значения.
Как отправлять новые параметры
Это зависит от вашего способа подключения (его можно посмотреть в личном кабинете, в настройках
API (интеграция по API ЮKassa)
Передавайте в параметре
receipt
в объекте
items
два новых параметра — для каждого товара:
  • признак предмета расчёта (
    payment_subject
    ),
  • признак способа расчёта (
    payment_mode
    ).
HTTP-протокол (интеграция по старому протоколу)
Передавайте в объекте
ym_mechant_receipt
два новых параметра — для каждого товара:
  • признак предмета расчёта (
    paymentSubjectType
    );
  • признак способа расчёта (
    paymentMethodType
    ).
Платёжный модуль в CMS
Новые параметры постепенно появляются в модулях ЮKassa. Точнее можно узнать в поддержке вашей платформы или у авторов модуля.
Выставление счетов из личного кабинета
Новые поля появятся при создании счёта. Вы сможете их указывать каждый раз или выбрать один раз для всех счетов.