Документ «Операция по Яндекс.Кассе» (Documents.ОперацияПоЯндексКассе)

1. Идентификация

Назначение. Документ отражает онлайн-оплату, поступившую через российский платёжный сервис Яндекс.Касса (ЮKassa): фиксирует транзакцию, платёж, перевод и возврат, разносит поступление денег, комиссию сервиса и расчёты с клиентом по данным платёжного шлюза.

⚠️ Специфика РК. Яндекс.Касса — российский сервис. В Республике Казахстан онлайн-оплаты учитываются через местный эквайринг и платёжные операции (документы эквайринга/операций по платёжным картам). В типовом учёте РК документ «Операция по Яндекс.Кассе», как правило, не используется — он остаётся в конфигурации как часть общего механизма УТ. Приведённые ниже проводки/счета РК даны для контекста плана счетов и справочно применимы к аналогичным операциям эквайринга.

Где найти в 1С (навигационная ссылка): e1cib/list/Документ.ОперацияПоЯндексКассе

2. Реквизиты шапки и табличные части

2.1. Реквизиты шапки

2.2. Табличные части

Основную нагрузку несёт шапка (модель «одна транзакция — один документ»): суммы платежа, комиссии и возврата хранятся в реквизитах шапки, а расшифровка расчётов ведётся через реквизит ОбъектРасчетов. Табличные части используются служебно (расшифровка платежей/объектов расчётов) в зависимости от ХозяйственнойОперации; их состав определяется выбранным видом операции.

3. Формы

Точный набор форм зависит от поставки; если специализированные формы не заданы, платформа использует автогенерируемые формы документа. — требует проверки в конкретной версии.

4. Ключевые процедуры модулей

Ниже — обработчики модуля объекта (ObjectModule), полученные статическим анализом BSL (имена — дословно из выгрузки).

Делегирование в ОбработкаПроведения. Формирование движений вынесено в общие модули оперативного контура УТ:

• ПроведениеСерверУТ — общий каркас проведения (наибольшее число вызовов);
• ДенежныеСредстваСервер — движения денежных средств и ДС в пути;
• ВзаиморасчетыСервер — расчёты с клиентами;
• ДоходыИРасходыСервер — прочие расходы/активы-пассивы (комиссия сервиса).

Прочие зависимости (общие модули): ОбщегоНазначения, СтроковыеФункцииКлиентСервер, ЗначениеНастроекПовтИсп, ОбщегоНазначенияКлиентСервер, Пользователи, ОбщегоНазначенияУТ, МенеджерОборудованияКлиентСервер, ПодключаемоеОборудованиеУТВызовСервера, ПрефиксацияОбъектовКлиентСервер.

Контроль/сообщения из кода: используется механизм формирования текста исключения (ТекстИсключения) при ошибках проверки/проведения.

5. Проведение и движения

Это торговая конфигурация — документ ведёт оперативный учёт через регистры накопления и сведений, а не бухгалтерские проводки Дт/Кт. По данным RegisterRecords документ формирует движения по 8 регистрам:

Логика движений (стандартная):

• поступление оплаты клиента увеличивает ДенежныеСредстваВПути (пока сервис не перечислил на банковский счёт) и уменьшает задолженность клиента в РасчетыСКлиентами/РасчетыСКлиентамиПоДокументам;
• удержанная сервисом комиссия отражается в ПрочиеРасходы/ПрочиеАктивыПассивы;
• денежные регистры (ДвиженияДенежныеСредства…) фиксируют потоки по статье ДДС и контрагенту;
• СуммыДокументовВВалютеРегл хранит эквивалент суммы в тенге для регламентированного контура.

Проекция на план счетов РК (справочно)

При отражении аналогичных операций эквайринга в регламентированном учёте РК задействуются счета Типового плана счетов:

В РК доход облагается НДС 16% (значение 2026 года; ставка 12% устарела). Электронный документооборот по реализации — ЭСФ (ИС ЭСФ) и СНТ там, где это требуется по номенклатуре.

6. Связанные объекты и ввод на основании

• Партнёры / Контрагенты / Организации / Банковские счета — источники заполнения шапки.
• Соглашения и объект расчётов — определяют условия и привязку взаиморасчётов (ОбъектРасчетов, ОснованиеПлатежа).
• Статьи ДДС, Статьи расходов — аналитика денежных и расходных движений.
• Перечисления ХозяйственныеОперации, СпособыОплатыЧерезЯндексКассу — управляют поведением документа.
• Ввод на основании / основания платежа — документ может создаваться на основании заказов/сделок клиента и, в свою очередь, служить основанием для последующих операций расчётов. Конкретный список команд ввода на основании определяется составом критериев отбора конфигурации. — требует проверки в конкретной версии.

7. Точки расширения

• Обработка проведения — расширение обработчика ОбработкаПроведения в модуле объекта или подписка на событие; корректный способ доработать состав движений — через общие модули оперативного контура (ПроведениеСерверУТ, ДенежныеСредстваСервер, ВзаиморасчетыСервер, ДоходыИРасходыСервер), а не переопределением регистров напрямую.
• Проверка заполнения — дополнение ОбработкаПроверкиЗаполнения собственными правилами контроля.
• Заполнение по умолчанию — расширение ОбработкаЗаполнения (в т.ч. под сценарии ввода на основании).
• Формы — расширение ФормаДокумента/ФормаСписка (добавление реквизитов, команд, условного оформления).
• Подписки на события (ПередЗаписью, ПриЗаписи) — для интеграций с внешними платёжными шлюзами без правки типового модуля.

Рекомендуется реализовывать доработки через Расширение конфигурации (заимствование обработчиков/форм), чтобы сохранить обновляемость типовой конфигурации.