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