Подключение и работа с ЮKassa в 1С:УНФ 3.0.13: пошаговая инструкция для РМК

Версия 3.0.13 программы 1С:Управление нашей фирмой добавила встроенную интеграцию с платежным сервисом ЮKassa. Эта функция позволяет принимать оплату картой через QR-код прямо на рабочем месте кассира без использования отдельного терминала эквайринга. Настройка выполняется в интерфейсе программы и не требует навыков программирования.

В этой инструкции мы подробно разберем, как подключить ЮKassу, активировать ее на кассе и начать принимать платежи. Вы узнаете о ключевом ограничении системы и о том, как правильно оформлять возвраты.

Что изменилось в версии 3.0.13: новая возможность приема платежей

Интеграция с ЮKassa - это нововведение версии 3.0.13. В отличие от стандартного эквайринга через банковский терминал, этот способ работает через API платежного агрегатора. Программа сама формирует платежную ссылку или QR-код, а клиент подтверждает транзакцию в своем мобильном банке или приложении ЮMoney.

Практическая польза для бизнеса - расширение спектра безналичных способов оплаты. Вы можете принимать платежи с карт любых банков, не арендуя дополнительное оборудование. Все настройки выполняются в интерфейсе 1С:УНФ.

Подготовка к подключению: что нужно от ЮKassa

Перед началом настройки в 1С соберите необходимые данные в личном кабинете ЮKassa. Это обеспечит непрерывный процесс подключения.

Вам понадобятся два параметра:

ID магазина (shopId). Это уникальный идентификатор вашего магазина в системе ЮKassa.
Секретный ключ. Ключ для подписи запросов. Рекомендуем создать отдельный ключ специально для интеграции с 1С.

Для тестирования настройки в личном кабинете ЮKassa должен быть включен «Боевой режим». Используйте тестовые карты, чтобы проверить работу без реального списания средств.

Пошаговая настройка ЮKassa в 1С:Управление нашей фирмой

Выполните эту последовательность действий, чтобы добавить и активировать новый способ оплаты.

Перейдите в раздел «Администрирование» → «Настройки программы» → «Безналичная оплата».
Нажмите кнопку «Создать» для добавления нового способа оплаты.
В открывшейся форме выберите тип «ЮKassa».
Заполните поля:
Название - укажите понятное для кассира название, например, «Оплата картой (ЮKassa)».
ID магазина - вставьте скопированный из личного кабинета ЮKassa shopId.
Секретный ключ - вставьте ключ. Поле ввода скрыто символами (точками). Проверьте, что ключ скопирован целиком, без пропусков.
Сохраните настройки.

Куда вводить ShopID и секретный ключ: интерфейс настроек

Окно настройки способа оплаты содержит три основных поля: «Тип», «Название» и блок параметров для ЮKassa. Ключ вводится в скрытом поле - при вставке вы увидите только точки. Ошибка в одном символе ключа или ID магазина приведет к сбою при проведении платежа. Проверьте данные перед сохранением.

Как активировать оплату на конкретной кассе (РМК)

Создание способа оплаты - это только первый шаг. Чтобы он появился в интерфейсе кассира, его нужно активировать для конкретной точки продаж.

Откройте справочник «Точки продаж».
Выберите нужную точку и перейдите в ее карточку.
Откройте вкладку «Торговое оборудование».
Найдите строку с нужным рабочим местом кассира и нажмите ссылку «Настройки».
В открывшемся окне перейдите на вкладку «Оплата».
Установите галочку напротив созданного вами способа «Оплата картой (ЮKassa)».
Сохраните изменения. Для применения настроек может потребоваться перезапуск рабочего места кассира.

Теперь способ оплаты доступен на РМК. Аналогичную настройку удобства приема платежей вы можете найти в нашей статье про новые возможности рабочего места кассира в 1С:УНФ 3.0.13.

Прием оплаты через ЮKassу на рабочем месте кассира

После настройки процесс приема оплаты становится простым для кассира и клиента.

Кассир формирует чек на рабочем месте кассира.
При нажатии кнопки «Оплата» открывается список доступных способов. Среди них будет пункт «Оплата картой (ЮKassa)».
После выбора этого способа система формирует платежную ссылку и отображает на экране РМК QR-код с суммой к оплате.
Клиент сканирует QR-код своим смартфоном. Его перебрасывает в приложение банка или ЮMoney для подтверждения платежа.
На экране РМК статус меняется с «Ожидание оплаты» на «Оплачено». Чек автоматически закрывается.

Важное техническое ограничение: способ оплаты выбирается для всего чека целиком. Оплата одной части наличными, а другой через ЮKassу в рамках одного чека невозможна.

Что видит кассир, а что - клиент

Кассир видит на экране РМК окно с крупным QR-кодом и суммой. После сканирования клиентом статус в этом окне обновляется. Клиент видит стандартный интерфейс своего банковского приложения с предложением подтвердить платеж. После успешной оплаты на его телефон может прийти электронный чек, если в настройках ЮKassa указан номер телефона или email.

Главное ограничение: почему нельзя split-оплату

Архитектура интеграции через API ЮKassa не поддерживает разделение одного чека на несколько платежных методов в рамках одного запроса. Это не ошибка вашей настройки, а особенность работы сервиса.

Решение для смешанной оплаты: оформите два отдельных чека. Первый чек - на часть суммы, которую клиент оплачивает наличными или картой через стандартный эквайринг. Второй чек - на оставшуюся сумму с оплатой через ЮKassу. Для работы с другими типами касс, включая облачные, изучите инструкцию по настройке и пробитию чеков через облачные кассы.

Оформление возврата и отладка проблем

Если клиент хочет вернуть товар, оплаченный через ЮKassу, операция выполняется из 1С.

На рабочем месте кассира выберите операцию «Возврат».
Найдите исходный чек по номеру или дате. Система подтянет все данные.
Проведите операцию возврата. 1С автоматически отправит запрос на возврат средств в ЮKassу.
Деньги будут возвращены на карту клиента. Срок зачисления зависит от правил банка-эмитента, обычно это 1-10 рабочих дней.

Стандартные ошибки и их решение:

«Неверный секретный ключ» - проверьте корректность копирования ключа из личного кабинета ЮKassa.
«Магазин не найден» - убедитесь, что в поле «ID магазина» указан правильный shopId.
«Оплата не прошла» - проверьте интернет-соединение на компьютере с РМК и убедитесь, что в личном кабинете ЮKassa включен «Боевой режим».

Статусы всех платежей можно отслеживать в журнале операций с торговым оборудованием или в отчетах по безналичным расчетам.

Пошаговый процесс возврата денег через ЮKassу

Возврат инициируется из 1С:УНФ. После проведения документа «Возврат» система формирует и отправляет соответствующий запрос в платежный шлюз ЮKassa. Вам не нужно заходить в личный кабинет ЮKassa для ручного создания возврата. Контролируйте статус операции в журналах 1С.

Проверка корректности работы и сверка

После настройки выполните тестовый прогон, чтобы убедиться в правильности работы.

Сделайте тестовый платеж на небольшую сумму (1-10 рублей).
Проверьте печатную форму чека. В ней должен быть указан способ оплаты «Безналичный» и, возможно, идентификатор транзакции.
Сверите выручку. Отчет «Отчет по розничным продажам» в 1С должен показывать сумму, равную успешным платежам через ЮKassa.
Регулярно проводите сверку с личным кабинетом ЮKassa. Суммарные поступления за день должны совпадать с данными в 1С за вычетом комиссии. Комиссия ЮKassa отражается в ее личном кабинете, в 1С же приходит чистая сумма оплаты.

Для комплексной проверки корректности учета после обновлений рекомендуем ознакомиться с материалами по актуальным изменениям, например, с обзором обновления 1С:Бухгалтерия 3.0.197.19, где разбираются смежные вопросы автоматизации учета.