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С.
- Выбрать нашу организацию и отчётный месяц.
- «Показать выборку» — превью счетов-фактур и счетов на оплату (строки — в модалке).
- «Скачать XML для 1С» — файл для загрузки штатной обработкой обмена в Бухгалтерию.
- Пустой период — сообщение в превью; скачать всё равно можно (получится файл без документов или с пустым набором — по факту ответа API).
- Вкладку «Счета-фактуры выданные» можно скачать в 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С.
- Подтверждение полной перезаписи при повторной загрузке месяца на боевой базе.
- При необходимости — уточнение серии номеров реализации/СФ и состава строк счёта на оплату по обратной связи бухгалтерии.