1С: изменения в v2
Новые возможности, совместимость и переход с первой версии интеграции.
Архивная редакция v2. Для новых подключений и доработки обработки используйте полное руководство и ТЗ v3. v3 — редакция документа; версия API не меняется.
Версия 2.0 · обновлено 28 сентября 2026 года
Полное руководство: Руководство v2.
Главное для лагеря
- Акты оказания услуг и УПД автоматически поступают из обновлённой обработки 1С на платформу «Наши лагеря».
- В карточке заказа в панели лагеря доступен блок Акты и УПД: номер, дата, редакция и просмотр PDF. Сотрудник может распечатать документ отдельно или включить его в комплект заказа или отряда. В ЛК родителя акты и УПД не отображаются и в его комплект не входят.
- Новая редакция заменяет текущую в интерфейсе с сохранением истории на сервере. Отозванный документ остаётся в списке с отметкой Отозван и без кнопки скачивания.
- В 1С можно загрузить PDF индивидуального договора как после онлайн-подписания, так и после дополнительной генерации при публичной оферте.
- Для оплат ЮKassa передаются подтверждённая сумма после удержаний и общая комиссия. Стоимость реализации и полная оплата родителя сохраняются; для отдельного учёта комиссии нужно обновить обработку 1С.
- Все соединения по-прежнему инициирует 1С. Публиковать базу 1С в интернете не требуется.
Автоматическая отправка требует обновления обработки/расширения 1С разработчиком лагеря. Релиз платформы предоставляет принимающий API и интерфейсы; изменения конфигурации 1С автоматически не устанавливаются.
Изменения API
| Область | Версия 1 | Версия 2 |
|---|---|---|
| Название услуги | Собирается обработкой из отдельных полей | Готовое service_description в формате чека |
| Номенклатура | Название смены | session.nomenclature_name с датами |
| Связи | Основная связь через номер заказа | Добавлены order_id и order_item_id |
| Изменение дат смены | Фильтр только по позиции заказа | Учитываются связанные данные в updated_at путёвки |
| Оплаты | Старое руководство описывало created_at | Актуальный отбор по updated_at, включая позднее подтверждение |
| Удержания ЮKassa | Отдельных полей нет | income_amount, fee_total, income_status; amount и final_price не уменьшаются |
| Договор | Номер и дата подписи | Отдельный список, версия, вид экземпляра и скачивание PDF |
| Акты и УПД | Приёма нет | Автоматический приём PDF, версии и отзыв |
| Постраничный обмен | Список меняется между запросами | Дополнительно доступны фиксированные пакеты на 24 часа |
| Диагностика | Проверка обычным запросом | accounting/connection, возможности и ограничения |
| Права ключа | Чтение и существующие интеграционные действия | Отдельное разрешение загрузки актов и УПД |
Исправление поздно подтверждённых платежей и точная связь с платежом ЮKassa появились в DEVEL ранее. Руководство v2 включает этот актуальный контракт; повторно реализовывать его не требуется.
Дополнение: удержания ЮKassa
В существующей выгрузке оплат и пакетах payments добавлены income_amount — подтверждённая сумма после удержаний — и fee_total — удержание с учётом НДС с комиссии. Суммы передаются строками с двумя десятичными знаками. Статус income_status=available означает, что данные получены; pending — ещё неизвестны; not_applicable — оплата не через ЮKassa. В двух последних случаях оба поля равны null, а не нулю.
Для автоматического получения комиссии и дозаполнения истории используйте пакеты resource=payments с next_updated_since. Обычный список оплат со страницами может пропустить записи при параллельном изменении updated_at, включая переход pending → available. Если данные отсутствуют у старой оплаты, платформа получает их в фоне из ЮKassa и обновляет updated_at оплаты. Следующий обмен возвращает её с прежним id; обработка дополняет данные и комиссию, не создавая оплату заново. Уже сформированный пакет не меняется: обновление следует получать следующим пакетом с сохранённым next_updated_since.
Учёт комиссии в 1С требует изменения обработки. Не вычитайте её из amount оплаты или final_price реализации. Разбивка удержания по услугам и НДС определяется по реестрам и УПД ЮKassa; новые поля не подтверждают банковское перечисление и не заменяют документы провайдера.
Оплаты родителей и фактическое перечисление
Обработка 1С должна учитывать полную оплату родителя через ЮKassa отдельно от поступления на банковский или лицевой счёт. Несколько оплат могут входить в один перевод; поступление отражается один раз по фактической банковской или казначейской выписке, с её суммой, датой и реквизитами плательщика. Не создавайте такие поступления по каждой оплате с платформы и не определяйте общий перевод суммой оплат за paid_at. ID платежа ЮKassa не является ID перечисления; название банка плательщика не определяет контрагента.
Документы и счета зависят от конфигурации: пример с «Оплатой платежной картой» и 57.03 относится к коммерческой «1С:Бухгалтерии», а в БГУ применяются свои документы и план счетов. Если бухгалтер использует 76.09, та же оплата не должна дублироваться через 57.03. Способ отражения СБП также согласуется для конкретной базы. fee_total нужен для удержания и сверки, а расход и НДС по УПД не должны начисляться второй раз. Подробный пример и источники приведены в разделе оплат полного руководства.
Если прежняя обработка уже создала отдельные поступления на счёт по оплатам родителей, согласуйте их исправление с бухгалтером, сохраните связи с ID платформы и оставьте реальную выписку в учёте один раз. Платформа сама не изменяет документы 1С; массовое удаление истории не является способом перехода.
Новые маршруты
Все пути ниже начинаются с /api/v1/public:
GET /accounting/connectionGET /accounting/contractsGET /accounting/contracts/{id}/file?version={version}PUT /accounting/documents/{kind}/{external_id}, гдеkind—actилиupdPOST /accounting/sync-batchesGET /accounting/sync-batches/{id}DELETE /accounting/sync-batches/{id}
Отзыв документа выполняется через тот же PUT с новой revision и status=revoked, без файла. Отдельного маршрута /revoke в итоговой реализации нет.
Совместимость и порядок перехода
- Сохранить существующие соответствия ID в 1С. Старые маршруты путёвок и оплат продолжают работать, их прежние поля сохранены.
- Установить обновление платформы в нужное окружение и обновить обработку 1С.
- Проверить
/accounting/connection: лагерь, окружение,api_version=2. - Администратору разрешить ключу Загрузка актов и УПД из 1С. Старые ключи не получают право автоматически. Новый ключ для чтения не обязателен.
- Сохранить постоянный
source_idбазы 1С. При ротации ключа не менятьsource_id, GUID документов и номера редакций. - Использовать готовые названия и ID позиций. Подключить отдельный поток договоров и скачивание с API-ключом.
- Включить автоматическую очередь публикаций/исправлений/отзывов актов и УПД; один номер версии должен соответствовать одному содержимому.
- Для нового обмена использовать пакеты и их
next_updated_since; старую границу не продвигать при неустранённой ошибке. - Проверить тестовый заказ в обоих кабинетах, затем включить регулярное задание на рабочей базе.
Выгрузка может повторно вернуть ранее загруженную запись: из-за изменившихся связанных данных, перекрытия времени или повторного запуска. Проверка существующего ID обязательна.
Отличия от предварительного предложения
- На платформе нет ручного подтверждения поступившего акта/УПД: публикация автоматическая после успешного приёма.
- Поддерживаются сразу два вида документов: акт и УПД.
- Приём использует двоичный PDF в
multipart/form-data; Base64 не используется. - Документ можно привязать к нескольким позициям одного заказа и лагеря. Документы разных заказов не объединяются.
- Договоры выгружаются отдельным потоком, в том числе до выпуска путёвки и при дополнительной генерации.
Что не входит в v2
Обратная передача банковской оплаты, выставление счетов, управление фактическим возвратом денег, получение банковских перечислений и разбивки комиссии ЮKassa по услугам/НДС, XML/ЭДО и электронное подписание актов/УПД на платформе остаются отдельными задачами. PDF, полученный из 1С, не меняет сумму заказа, факт оплаты или кассовые чеки.