Интеграция с 1С
Продажи, оплаты и комиссии ЮKassa в 1С, договоры, акты и УПД.
Платформа «Наши лагеря» предоставляет данные продаж, оплат, комиссий и индивидуальных договоров для «1С:Бухгалтерии предприятия». Разработчик должен настроить обработку вашей базы: после доработки она получает эти данные по расписанию и отправляет готовые акты и УПД по заказам в панель лагеря на платформе «Наши лагеря». Руководство v3 — новая редакция ТЗ, адреса и версия API сохраняются.
Подключение
- Обратитесь в поддержку для выдачи API-ключа и разрешения загрузки актов и УПД.
- Передайте вашему разработчику 1С полное руководство и ТЗ v3.
- Разработчик обновит обработку: настроит получение договоров и автоматическую отправку готовых актов и УПД, исправлений и отзывов.
- Проверьте тестовый заказ перед включением рабочего обмена.
Все соединения инициирует 1С. Доступ из интернета к вашей базе 1С не требуется.
Оплаты и комиссия ЮKassa
Стоимость реализации и оплата родителя передаются в полной сумме. Например, при оплате 10 000 ₽ и удержании ЮKassa 305 ₽ реализация и оплата остаются по 10 000 ₽, а комиссия 305 ₽ передаётся отдельно. Сумма после удержаний составляет 9 695 ₽.
Попросите разработчика обновить обработку 1С для получения комиссии через пакеты синхронизации по руководству API. Пакеты нужны, чтобы фоновое дозаполнение сумм не приводило к пропускам оплат между страницами. Документы и проводки согласуйте с бухгалтером; уже удержанную комиссию повторно перечислять ЮKassa не нужно. Разбивку услуг и НДС проверяйте по реестрам и УПД ЮKassa.
Если у старой оплаты сумма после удержаний не сохранена, платформа запрашивает её у ЮKassa в фоне. После получения данные поступят следующим обменом как обновление той же оплаты. Пока они не получены, комиссия считается неизвестной, а не нулевой. Обработка должна дополнять существующую запись и исключать дубли при загрузке выписки или данных из других модулей.
Как избежать дублей с выпиской
Платёж родителя через ЮKassa учитывается отдельно от фактического поступления денег на расчётный счёт лагеря. Обработка не должна создавать такое поступление от каждого родителя, если затем банковская выписка загружает общее перечисление платёжного сервиса.
Например, три родителя оплатили по 10 000 ₽, общая комиссия — 915 ₽. Если других удержаний, возвратов и остатков нет, один перевод составит 29 085 ₽. В 1С сохраняются три полные оплаты на 30 000 ₽, а поступление на счёт создаётся один раз по выписке на 29 085 ₽. Удержание и расход по комиссии сверяются отдельно; один и тот же расход не начисляется повторно при загрузке УПД.
Передайте разработчику раздел об оплатах в руководстве API. Для карточных оплат БП используется согласованная с бухгалтером схема расчётов с платёжным сервисом. Документы и счета, включая учёт СБП, настраиваются под версию БП, расширения и учётную политику вашей базы.
Дату, сумму и реквизиты плательщика берите из выписки. Сумма вчерашних оплат не определяет состав перевода, а банк плательщика не обязательно является контрагентом по договору.
Если лишние поступления на счёт уже созданы, бухгалтер и разработчик должны согласовать их исправление с сохранением связей с заказами и оплатами. Не удаляйте историю автоматически. Обновление платформы само не меняет документы в вашей 1С.
Что автоматизируется, а что делает бухгалтер
После доработки и настройки обработки автоматически загружаются штатные оплаты, изменения комиссии и договоры; подготавливаются данные реализации и готовые акты/УПД поступают в панель лагеря. Условия и дату проведения документов утверждает бухгалтер.
Банковская выписка подключается отдельно. Для сверки общего перечисления с платежами нужен реестр провайдера. Входящие УПД ЮKassa за комиссию поступают через отдельный ЭДО, импорт или бухгалтера: они не относятся к исходящим УПД лагеря, которые видны сотрудникам в карточке заказа.
Это не полная бухгалтерия без участия человека. Бухгалтер выбирает учётную схему, контролирует первичные документы, исключения и расхождения, закрывает периоды и отвечает за отчётность. Платформа не исправляет проводки в 1С автоматически.
Договоры
В 1С передаётся готовый PDF индивидуального договора:
- подписанный онлайн экземпляр;
- документ, созданный дополнительной генерацией договоров, в том числе при публичной оферте.
Сам факт генерации PDF не означает, что договор подписан. Настройка дополнительной генерации находится в документах лагеря.
Акты и УПД в заказе
Откройте карточку заказа и найдите блок Акты и УПД. Здесь отображаются тип, номер, дата и редакция каждого документа. Нажмите Открыть, чтобы просмотреть PDF и отправить его на печать. Документы также доступны в меню Распечатать.
Акты и УПД доступны только сотрудникам в панели лагеря. В ЛК родителя они не отображаются и в скачиваемый комплект не входят. Дополнительного подтверждения на платформе не требуется. Новые документы появляются после успешного обмена 1С; для просмотра обновлений откройте заказ заново или обновите страницу.
Чтобы включить эти документы в общий PDF, откройте Настройки → Документы → Печать и скачивание, отметьте Акты и УПД в комплекте заказа или отряда и нажмите Сохранить комплекты. В комплект попадут текущие опубликованные редакции.
Исправление и отзыв
Исправляйте документ в 1С. Обработка отправит новую редакцию автоматически. Платформа показывает текущую редакцию, сохраняя историю на сервере.
При отзыве в 1С после обмена появится отметка Отозван, скачивание станет недоступным. Уже скачанные копии остаются у получателей.
Если документ не появился
Попросите разработчика проверить журнал обмена в 1С, правильность API-ключа и разрешение загрузки. Для поддержки сохраните время ошибки, номер документа и trace_id. Не отправляйте ключ в общий чат.