Данная разработка предназначена для пользователей и разработчиков системы 1С:Предприятие, которым необходим эффективный инструмент для взаимодействия с платежной системой ЮKassa.

• Для пользователей (бухгалтеров, менеджеров, руководителей):

  • Оперативный доступ к финансовым данным ЮKassa прямо из интерфейса 1С.

  • Наглядный анализ платежей, возвратов, среднего чека и других метрик на Дашборде.

  • Возможность формировать запросы к ЮKassa (например, "показать все платежи за прошлый месяц" или "создать платеж на 1000 руб.") на естественном русском языке.

• Для программистов 1С:

  • Готовая основа для глубокой интеграции данных ЮKassa с любой конфигурацией 1С.

  • Легкий доступ к "сырым" JSON-ответам от API ЮKassa для их последующей обработки, загрузки в документы или регистры 1С.

  • Открытый код обработки и HTML/JS-компонентов для изучения и адаптации.

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

История создания

Разработка была инициирована с целью предоставить пользователям 1С удобный и современный способ работы с ЮKassa. Основной упор был сделан на создание как готового к использованию инструмента, так и гибкой платформы для разработчиков, позволяющей легко интегрировать данные ЮKassa в существующие бизнес-процессы на платформе 1С.

Основной функционал – Два мощных инструмента в одной обработке!

Программа включает два функциональных блока, доступных через вкладки в основной форме обработки:

Блок 1: Наглядный Дашборд ЮKassa в 1С

Этот блок предназначен для визуализации и анализа данных о финансовых операциях, проведенных через ЮKassa.

• Ключевые финансовые показатели: Наглядное отображение выручки, суммы возвратов, среднего чека, количества платежей и других метрик за выбранный период.

• Интерактивный график: Визуализация динамики выбранных показателей (по дням, неделям, месяцам). Пользователь может выбирать одну или несколько метрик для одновременного отображения на графике.

• Детализированная история операций: Таблица со списком платежей, возвратов, чеков и счетов, оснащенная фильтрами (по дате, типу объекта, сумме, статусу, способу оплаты) и полнотекстовым поиском. 

• Процесс получения данных: Пользователь выбирает период и нажимает "Получить данные". Обработка 1С передает необходимые параметры аутентификации (Shop ID, Secret Key) в HTML-компонент дашборда, который загружает информацию напрямую из API ЮKassa.

• Возможности для разработчиков (кастомизация):

  • На вкладке "Ответ JSON" дашборда отображаются полные, неструктурированные JSON-ответы от API ЮKassa, сгруппированные по категориям (Платежи, Чеки, Возвраты, Счета).
    

  • Для каждой категории данных (например, "Платежи") предусмотрена кнопка "Отправить данные в 1С". При нажатии на эту кнопку, содержимое соответствующего текстового поля (JSON-строка) передается в специальный текстовый реквизит на форме обработки 1С.

  • Это позволяет программисту 1С получить доступ к полному набору данных в формате JSON для дальнейшей программной обработки средствами 1С: парсинг JSON, создание или обновление документов и справочников, запись в регистры и т.д., в соответствии с логикой конкретной конфигурации 1С.

Блок 2: Управление ЮKassa через Искусственный Интеллект (ИИ)

Данный модуль позволяет взаимодействовать с API ЮKassa, используя запросы на естественном русском языке, а также выполнять операции, такие как создание платежей

• Принцип работы: Пользователь вводит запрос на русском языке (например, "Покажи все возвраты за текущий квартал" или "Создай платёж на сумму 550 рублей, описание 'Оплата заказа 123'"). Искусственный интеллект (LLM) анализирует запрос, преобразует его в JSON-команду для API ЮKassa, отправляет команду и получает ответ.

• Отображение результата:

  • На вкладке "Ответ через ИИ" выводится результат, отформатированный ИИ для удобного восприятия (таблицы, списки, текстовые пояснения).
    

• Примеры запросов: В интерфейсе доступен список примеров для быстрого освоения.

• Поддерживаемые операции: Включают создание платежей, получение информации о платежах и их списках, отмену платежей, создание и просмотр возвратов, чеков, сделок и выплат. Полный список поддерживаемых методов API доступен во встроенной справке.

• Возможности для разработчиков (кастомизация):

  • На вкладке "Ответ ЮKassa (JSON)" отображается "сырой" JSON-ответ, полученный непосредственно от API ЮKassa в результате выполнения команды, сформированной ИИ.

  • Аналогично дашборду, здесь также присутствует кнопка "Отправить данные в 1С". При ее нажатии, JSON-ответ со вкладки "Ответ ЮKassa (JSON)" передается в текстовый реквизит на форме обработки 1С.
    

  • Это открывает широкие возможности для разработчиков: можно использовать этот JSON для автоматического создания документов в 1С на основе информации о платеже, обновления статусов заказов, или любой другой логики, специфичной для используемой конфигурации 1С.

Ключи для работы: Настройка

1. ЮKassa (Номер магазина и Секретный ключ):

• Получаются в личном кабинете ЮKassa (раздел "Интеграция" -> "Ключи API").

• Скопируйте Shop ID (Номер магазина) и Секретный ключ.

• Введите их в соответствующие поля в шапке обработки 1С. 

2. Искусственный Интеллект (через OpenRouter):
Для работы модуля "Управление ЮKassa через ИИ" требуется подключение к LLM через OpenRouter.

• Регистрация и API Key: Зарегистрируйтесь на https://openrouter.ai/ и создайте API-ключ в разделе "Keys" (https://openrouter.ai/keys).

• Base URL: https://openrouter.ai/api/v1/chat/completions

• Model ID: Выберите модель из списка на OpenRouter (например, бесплатные deepseek/deepseek-chat:free, qwen/qwen3-30b-a3b:free). Список бесплатных моделей: https://openrouter.ai/models?max_price=0.

• Введите API key, Base URL и Model ID в поля в шапке обработки 1С. 
  

Технические аспекты и возможности кастомизации

• Универсальность: Обработка разработана как внешняя (.epf) и не привязана к конкретной конфигурации 1С. Может использоваться в любой конфигурации на управляемых формах, поддерживающей HTML-поля.

• Платформа: Рекомендуется 1С:Предприятие 8.3.18 и выше.

• Открытый код:

  • Код самой обработки 1С (модуль формы, модуль объекта если есть) полностью открыт.

  • HTML, CSS и JavaScript код, формирующий интерфейсы Дашборда и ИИ-модуля, содержится в текстовых макетах обработки и также полностью доступен для изучения, модификации и адаптации.

• Гибкость для разработчиков:

  • Прямая передача JSON в 1С: Как описано выше, ключевой особенностью является возможность передачи "сырых" JSON-ответов от API ЮKassa (как из Дашборда, так и из ИИ-модуля) в реквизиты формы 1С. Это значительно упрощает дальнейшую интеграцию: разработчику не нужно самостоятельно реализовывать логику запросов к API ЮKassa или парсить HTML. Он получает готовые данные в универсальном формате JSON.

  • Примеры использования передаваемых JSON:

    • Автоматическое создание документов "Поступление на расчетный счет" на основе данных о платежах.

    • Обновление статусов заказов покупателей в 1С при получении информации об успешной оплате.

    • Формирование чеков в 1С на основе данных от ЮKassa.

    • Ведение расширенной аналитики по данным ЮKassa с использованием регистров 1С.

• Работа в базовой версии: Да, при условии поддержки конфигурацией внешних обработок с HTML-полями.

• Работа в сервисе 1С:Фреш: Не поддерживается.

• Требования: Необходимо активное интернет-соединение.

Преимущества решения

• Два инструмента в одном: Комплексный подход к работе с ЮKassa – анализ и управление.

• Экономия времени: Быстрый доступ к данным и операциям без покидания 1С.

• Удобство для пользователей: Интуитивно понятные интерфейсы, возможность общения с системой на естественном языке.

• Мощные возможности для разработчиков: Легкая интеграция данных ЮKassa в любую конфигурацию 1С благодаря передаче "сырых" JSON-ответов.

• Готовое к использованию "из коробки": После простой настройки ключей, пользователи могут сразу начать работать с данными.

Отраслевая применимость

Решение подходит для любого бизнеса, использующего ЮKassa для приема платежей, независимо от отрасли: розничная и оптовая торговля, услуги, онлайн-образование, SaaS и т.д.

Интерфейс

• Интерфейсы Дашборда и ИИ-модуля реализованы с использованием HTML, CSS и JavaScript, обеспечивая современный вид и интерактивность.

• Встроенная справка на соответствующих вкладках каждого модуля.

Безопасность

• Все коммуникации с API ЮKassa и OpenRouter осуществляются по защищенному протоколу HTTPS.

• Ключи API (ЮKassa, OpenRouter) передаются из реквизитов 1С в момент выполнения запроса и не хранятся в HTML-коде или браузере постоянно. В логах чувствительные данные маскируются.

Состав поставки

• Внешняя обработка для 1С:Предприятие 8.3 (файл с расширением .epf).

• Инструкции по настройке и использованию интегрированы в интерфейс обработки (вкладки "Справка").

Инструкция по запуску обработки

Данная разработка — это внешняя обработка (.epf).

Вы можете использовать её двумя способами:

1. Открыть напрямую через механизм открытия файлов:

• В 1С перейдите в меню Файл → Открыть.

• Выберите файл обработки .epf.

• Откройте её как внешнюю обработку.

2. Подключить к типовой конфигурации 1С через механизм "Дополнительные отчёты и обработки":

• Перейдите в раздел Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки.

• Добавьте новую внешнюю обработку, указав путь к файлу .epf.

• Настройте права доступа для пользователей, если требуется.

В обоих случаях обработка готова к использованию сразу после открытия: достаточно ввести ID магазина, секретный ключ и выбрать период для загрузки данных.

Часто задаваемые вопросы (FAQ)

• В: Как именно JSON передается в 1С?
  О: На вкладках "Ответ JSON" (в Дашборде) и "Ответ ЮKassa (JSON)" (в ИИ-модуле) есть кнопки "Отправить данные в 1С". При нажатии, текст из соответствующего textarea (содержащий JSON) копируется в предопределенный текстовый реквизит на форме самой обработки 1С. Далее программист может в коде 1С обратиться к этому реквизиту, прочитать JSON-строку и обработать ее.

• В: Могу ли я использовать эту обработку для автоматического обмена данными с ЮKassa по расписанию?
  О: В текущем виде обработка ориентирована на интерактивную работу пользователя. Однако, поскольку код 1С открыт, разработчик может использовать ее логику и функции для создания регламентных заданий, которые будут вызывать получение и обработку данных из ЮKassa автоматически (потребуется адаптация для неинтерактивного вызова).

• В: Какие версии конфигураций 1С поддерживаются?
  О: Любые современные конфигурации на управляемых формах. Главное условие – поддержка платформой 1С отображения HTML-полей и выполнения JavaScript в них.