Ключевые возможности
- Универсальная выгрузка -- список документов формируется автоматически из метаданных конфигурации, не требуется ручная настройка под конкретную конфигурацию.
- Полнота данных -- выгружаются реквизиты документа, все табличные части и движения по регистрам.
- Поддержка регистров -- регистры накопления (остатки и обороты) и регистр бухгалтерии "Хозрасчётный" (с полной детализацией проводок, субконто, сумм, количеств).
- Выборочная выгрузка -- пользователь может отметить флажками только нужные типы документов и регистры движений.
- Автоматический подсчёт -- при выборе периода обработка подсчитывает количество проведённых документов каждого типа и автоматически отмечает документы, по которым есть данные.
- Сохранение ссылочной целостности -- для всех ссылочных реквизитов выгружаются представление (текстовое значение) и UUID (уникальный идентификатор), что позволяет однозначно идентифицировать объекты при загрузке.
- Корректная обработка перечислений -- значения перечислений выгружаются без лишнего преобразования в UUID.
- Оптимизация производительности -- формирование JSON через массив строк с последующей сборкой, пакетные запросы, предварительная проверка наличия движений по регистрам.
- Работа через временное хранилище -- файлы формируются на сервере и передаются клиенту через механизм временного хранилища, что позволяет работать в тонком клиенте и веб-клиенте.
Порядок работы
- При открытии обработки автоматически заполняется список всех документов конфигурации с их движениями по регистрам.
- Пользователь задаёт период выборки -- обработка подсчитывает количество проведённых документов за период и отмечает флажками типы, по которым есть данные.
- Пользователь выбирает каталог для сохранения файлов.
- По нажатию кнопки "Выгрузить" для каждого отмеченного типа документов:
- формируется пакетный запрос, включающий выборку реквизитов, табличных частей и движений по регистрам;
- результат преобразуется в структурированный JSON;
- файл сохраняется в выбранный каталог.
Формат выходного файла
Для каждого типа документов создаётся отдельный JSON-файл с именем вида: ВидДокумента_ГГГГ-ММ-ДД данные за период ГГГГ-ММ-ДД - ГГГГ-ММ-ДД.json
Структура JSON:
{
"remotes": [{
"name": "entries-update",
"data": [
{
"ТипДокумента": "Реализация товаров и услуг",
"Реквизиты": {
"Проведен": true,
"Дата": "2025-01-15T00:00:00",
"Номер": "00000123",
"Контрагент": {
"Представление": "ООО Ромашка",
"Ссылка": "a1b2c3d4-..."
}
},
"ТабличныеЧасти": {
"Товары": [{
"Номенклатура": {
"Представление": "Товар 1",
"Ссылка": "e5f6a7b8-..."
},
"Количество": 10,
"Сумма": 5000.50
}]
},
"Движения": {
"Хозрасчетный": [{
"Период": "2025-01-15T00:00:00",
"СчетДт": {
"Представление": "62.01",
"Ссылка": "..."
},
"СчетКт": {
"Представление": "90.01.1",
"Ссылка": "..."
},
"СубконтоДт1": { ... },
"Сумма": 5000.50,
"Содержание": "Реализация"
}],
"ТоварыНаСкладах": [{
"Номенклатура": { ... },
"Склад": { ... },
"Количество": 10
}]
}
}
]
}]
}
Правила сериализации типов данных:
- Числа -- без разделителей групп, с точкой в качестве десятичного разделителя; нулевые значения заменяются пустой строкой
- Даты -- формат ISO
yyyy-MM-ddT00:00:00 - Булево --
true/false - Строки -- экранирование спецсимволов (
\,", переносы строк, табуляции) - Ссылочные типы -- объект с полями
Представление(строка) иСсылка(UUID) - Перечисления -- выгружаются значением перечисления с представлением
Поддерживаемые регистры
| Вид регистра | Поддержка |
|---|---|
| Регистры накопления (остатки) | Полная: измерения, ресурсы, реквизиты + ВидДвижения |
| Регистры накопления (обороты) | Полная: измерения, ресурсы, реквизиты |
| Регистр бухгалтерии "Хозрасчётный" | Полная: счета Дт/Кт, субконто (3 уровня), организация, подразделения, суммы, количества, содержание |
| Регистры сведений | Пропускаются |
| Регистры расчёта | Пропускаются |
Технические особенности
- Платформа: 1С:Предприятие 8.3 (версия метаданных 2.20)
- Тип: внешняя обработка (
.epf) - Форма: управляемая (основная), обычная (заглушка)
- Клиенты: тонкий клиент, веб-клиент (с расширением работы с файлами)
- Метод формирования JSON: ручная сборка через массив строк (без использования объектов
ЗаписьJSONплатформы) - Оптимизация: пакетные запросы с промежуточными таблицами, предварительная проверка наличия движений, кэширование типов перечислений
Совместимость
Обработка является конфигурационно-независимой: список документов и структура запросов формируются динамически на основе метаданных. Подходит для любой конфигурации, содержащей документы с движениями по регистрам накопления и/или регистру бухгалтерии "Хозрасчётный" (типовые конфигурации "Бухгалтерия предприятия", "Управление торговлей", "ERP" и др.).
Проверено на следующих конфигурациях и релизах:
- Бухгалтерия предприятия, редакция 3.0, релизы 3.0.193.19, 3.0.191.41, 3.0.190.22
Вступайте в нашу телеграмм-группу Инфостарт
