Перейти к основному содержимому

2026-09-25 — Выгрузка в 1С (бухгалтерия): документы и номенклатура

Статус: Реализовано (v1)

Источник / заказчик: Алексей

Эпик: ITR-3083

Связанные материалы: синхронизация с 1С (импорт Excel из 1С — другой контур), отгрузки: shipment.md, карта полей: export-1c-field-map.md.

Образец формата: XML-файл обмена 1С (ФайлОбмена) — «Файл выгрузки.xml».
Правила обмена: ПКОлмаг_ПравилаОбмена_УНФ2БП_20260909 (Ид cd80efca-…, УНФ → Бухгалтерия предприятия).

Цель​

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

Итог v1​

Реализованы выборка, формирование XML и экран бухгалтера (превью + скачивание).

Ограничение первой реализации: в бою выгрузка рассчитана на одну нашу организацию — ПК ОлМаг (коды / соответствие организации в 1С уже есть в правилах и эталоне). Остальные наши организации в UI можно выбрать, но коды организаций в 1С для них ещё не заведены — после тестирования загрузки на боевой 1С коды будут добавлены в ИС, и выгрузка по ним станет полноценной.

Автозапуск по расписанию — вне scope (как и было).

ИС (документы + номенклатура за месяц, выбранная наша org)
↓ XML (ФайлОбмена)
бухгалтер загружает в 1С «Бухгалтерия предприятия»

Контекст​

Было​

  • В ИС — отгрузочные документы и счета на оплату; готовой выгрузки ИС → 1С не было.
  • Обмен с 1С — в основном Excel из 1С → импорт в ИС (другой контур).

Стало​

  • Бухгалтер выбирает нашу организацию и месяц, смотрит превью выборки, скачивает XML.
  • В файле — документы только выбранной организации за период; номенклатура и связанные справочники в объёме, нужном для загрузки.
  • Повторная выгрузка того же месяца → при загрузке в 1С ожидается полная перезапись найденных документов.

Состав выгрузки​

Что нужно заказчикуВ XML (как в эталоне)
УПД / ТОРГ-12Реализация (товары), признак УПД через правила загрузки; отдельного типа «УПД» в эталоне нет
Акт выполненных работРеализация (услуги)
Счёт-фактураСчёт-фактура выданный (основание — реализация)
Счёт на оплатуСчёт на оплату покупателю
НоменклатураСправочник по строкам документов

1-Т / ТТН как отдельный тип — вне scope.

УПД и ТОРГ-12 на одной отгрузке​

В эталоне нет отдельного типа УПД → вариант А: одна реализация с признаком универсального документа (+ СФ).
УПД и ТОРГ-12 на одной отгрузке → одна реализация (не дублировать).

Формат и запуск​

  • XML ФайлОбмена + блок правил заказчика; приёмник — Бухгалтерия предприятия.
  • Период: календарный месяц (по умолчанию в UI — прошлый).
  • Кто: роль бухгалтер (кнопка); Admin может смотреть экран, скачивание — у бухгалтера.
  • Автозапуск — вне эпика.

Как пользоваться (кратко)​

  1. Меню финансов → выгрузка / экспорт в 1С.
  2. Выбрать нашу организацию и отчётный месяц.
  3. «Показать выборку» — превью счетов-фактур и счетов на оплату (строки — в модалке).
  4. «Скачать XML для 1С» — файл для загрузки штатной обработкой обмена в Бухгалтерию.
  5. Пустой период — сообщение в превью; скачать всё равно можно (получится файл без документов или с пустым набором — по факту ответа API).
  6. Вкладку «Счета-фактуры выданные» можно скачать в CSV для сверки (добавлено в 1.15.0); у вкладки «Счета на оплату» такой кнопки нет.

Пользовательское описание: Финансы и бухгалтерия.

Отличие от старого контура: это выгрузка из ИС в 1С, не импорт Excel из 1С в ИС.

Принятые решения​

ТемаРешение
НаправлениеИС → 1С (XML), не импорт Excel из 1С
ДокументыУПД/ТОРГ-12 → реализация; акт; СФ; счёт на оплату; номенклатура
ПериодМесяц; по умолчанию прошлый
ИнициаторБухгалтер, кнопка
Наша организацияВыбор в UI; в файле только эта org
Коды org в 1С (v1)Только ПК ОлМаг; остальные — после теста на боевой 1С
Ключ номенклатурыНаименование (коды ИС и 1С не совпадают)
Повтор месяцаПолная перезапись в 1С по правилам поиска обмена
АвтозапускВне scope
API 1СНет

Задачи эпика​

#ЗадачаСтатус
1Карта полей эталона XMLГотово — export-1c-field-map.md
2Бек. Выборка данных за месяцГотово
3Бек. Формирование XMLГотово
4Фронт. Экран выгрузки (превью + скачивание)Готово
5Документация / инструкцияЭтот документ + карта полей; краткий сценарий выше

Критерии приёмки​

  • Бухгалтер выбирает организацию и месяц, выгружает XML; в файле только документы выбранной организации.
  • В выгрузке: реализации (УПД/ТОРГ-12/акт), СФ, счета на оплату за период + номенклатура строк.
  • Формат — ФайлОбмена по правилам заказчика.
  • Запуск у бухгалтера; автозапуска в эпике нет.
  • Пустой период — понятное поведение в превью.
  • Повторная загрузка того же месяца на боевой 1С — подтвердить полной перезаписью после теста.
  • Коды 1С для остальных наших организаций — после теста на боевой 1С.

Вне scope​

  • Импорт Excel из 1С в ИС.
  • Прямой API / онлайн-синхронизация с 1С.
  • Автозапуск выгрузки.
  • 1-Т / ТТН как отдельный тип.
  • Маппинг кодов 1С для всех наших org в первой поставке (только ПК ОлМаг).

Открытые / отложенные​

  1. Коды наших организаций в 1С (кроме ПК ОлМаг) — добавить в ИС после успешного теста загрузки на боевой 1С.
  2. Подтверждение полной перезаписи при повторной загрузке месяца на боевой базе.
  3. При необходимости — уточнение серии номеров реализации/СФ и состава строк счёта на оплату по обратной связи бухгалтерии.