Инструкции
Помощь
Подключить ЮKassa
Отправка чеков по 54-ФЗ
По закону 54-ФЗ при оплате товаров, работ или услуг необходимо формировать фискальный чек и отправлять его в налоговую с помощью онлайн-кассы.
Решение ЮKassa для работы по 54-ФЗ позволяет настроить взаимодействие с вашей онлайн-кассой. ЮKassa передает онлайн-кассе данные для формирования чека, например количество и стоимость товаров, и узнает результат. Подробнее о взаимодействии
Порядок интеграции
  1. Подключите онлайн-кассу одного из партнеров ЮKassa и заключите договор с оператором фискальных данных (ОФД).
  2. Заполните настройки для работы по 54-ФЗ в личном кабинете ЮKassa.
  3. Настройте передачу данных для формирования чеков при платежах и возвратах.
Возможности API
С помощью API ЮKassa вы можете:
  • отправлять онлайн-кассе данные для формирования чеков в соответствии с форматом фискальных документов (ФФД) 1.05, 1.1 и 1.2. Подробнее про то, как перейти на ФФД 1.2;
  • создавать чеки платежей и возвратов, в том числе закрывающие чеки в зачет аванса или предоплаты;
  • получать информацию о чеках, созданных с помощью ЮKassa.
Сценарии отправки чека
API ЮKassa поддерживает три сценария передачи данных для формирования чека: Платеж и чек одновременно, Сначала чек, потом платеж и Сначала платеж, потом чек. Сценарии отличаются способом и моментом отправки данных для формирования чека прихода и чека возврата прихода. Чек зачета предоплаты всегда отправляется отдельным запросом.
Платеж и чек одновременно
Этот сценарий подойдет большинству магазинов.
Как передавать данные:
Процесс платежа и отправка данных для формирования чека будут происходить параллельно. В течение трех дней ЮKassa будет ожидать ответ от онлайн-кассы. Если по какой-то причине чек не зарегистрируется, вы сможете сделать это самостоятельно через онлайн-кассу. Неуспех при регистрации чека никак не повлияет на платеж.
Чтобы подключить этот сценарий, в личном кабинете ЮKassa, в разделе Настройки — Онлайн-касса, выберите режим Принимать платеж.
Сначала чек, потом платеж
Этот сценарий подойдет магазинам, которым важно, чтобы ни один платеж не прошел без чека. Например, тем, кто продает цифровые товары.
Как передавать данные:
ЮKassa отправит данные в онлайн-кассу сразу после создания объекта платежа  и в течение пяти минут будет ожидать ответ. Если за это время онлайн-касса не сообщит об успешной регистрации чека, ЮKassa отменит платеж и вернет деньги пользователю.
Чтобы подключить этот сценарий, в личном кабинете ЮKassa, в разделе Настройки — Онлайн-касса, выберите режим Отменять платеж.
Сначала платеж, потом чек
Этот сценарий подойдет магазинам, которые хотят отправлять чек отдельно от платежа и самостоятельно контролировать этот процесс по API ЮKassa. Например, тем, кто выступает в роли агента. Сценарий обязателен для тех, кто использует Сплитование платежей или Безопасную сделку.
Как передавать данные:
ЮKassa сразу отправит вашей онлайн-кассе данные для регистрации чека, а вам в ответ на запрос передаст объект чека . Если по каким-то причинам чек не зарегистрируется в онлайн-кассе, на платеж это не повлияет.
Для одного платежа или возврата можно создать не более 15 чеков.
Чтобы подключить этот сценарий, в личном кабинете ЮKassa, в разделе Настройки — Онлайн-касса, выберите режим Не связывать чек и платеж. Если используете Безопасную сделку, сценарий уже подключен по умолчанию.
Что почитать еще
Переход на ФФД 1.2Формирование чеков при платежахФормирование чеков при возвратахВыгрузка данных по чекам