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