cursor-1c/тара.md

ТЗ на доработку: учёт номерной тары

Дата: 07.10.2026
Конфигурация: ВесоваяАК (ves2020)
Версия конфигурации (на момент анализа): 0.0.3.21
Область: учёт номерной тары при отгрузке (Расходная накладная)
Тип работ: новая функциональность (метаданные + форма/проведение документа)

Документ сформирован по постановке заказчика с уточнением имён объектов по текущим исходникам/ИБ. Правки в конфигурацию этим документом не вносятся.

---

1. Цель и критерии успеха

1.1. Цель

Обеспечить учёт индивидуальной (номерной) тары при отгрузке по Расходной накладной:

• вести справочник экземпляров номерной тары в разрезе типа фасовки;
• при признаке «номерная тара» у типа фасовки — обязательно фиксировать конкретные экземпляры в документе;
• отражать расход в регистре накопления остатков;
• не регистрировать изменения ТЧ номерной тары на выгрузку в БЭКЗ (на текущем этапе).

1.2. Критерии приёмки

№	Критерий	Как проверить
К1	У экзТипыФасовки есть реквизит «Номерная тара» (Булево); просмотр всем, изменение — только Полные права	Роли / форма элемента
К2	Создан справочник номерной тары с владельцем экзТипыФасовки, длина наименования 25; есть загрузка из Excel по выбранному владельцу	Метаданные + сценарий загрузки
К3	Создан РН остатков «Учет номерной тары» с заданным составом; регистратор — РасходнаяНакладная	Метаданные регистра
К4	В РНК при заполненном ТипФасовки с признаком «Номерная тара» отображается ТЧ, число строк = КоличествоМест, заполнение обязательно, выбор ограничен владельцем	UI + проведение с ошибкой при пустых/неполных строках
К5	При проведении формируются движения расхода (Количество = 1 на строку); при отмене проведения / пометке на удаление движения снимаются без дублей при повторном проведении	Остатки регистра до/после
К6	Изменение только ТЧ «Учет номерной тары» не приводит к регистрации документа в плане обмена агк_ОбменВесоваяБЭКЗ	Узлы обмена / регистрация изменений
К7	Константа/настройка «Использовать остатки номерной тары» создана; в РНК пока выбор всех элементов по владельцу (без отбора по остаткам)	Константа + форма выбора
К8	П.6 (документ «Приход номерной тары», отчёт о движении) — вне срока до 07.10.2026, допускается отдельной задачей	Согласование сроков

---

2. Фактический контекст конфигурации (as-is)

Объект в постановке	Факт в конфигурации
Справочник «Тип фасовки»	Справочник.экзТипыФасовки (синоним: «Типы фасовки»)
Реквизит «Тип фасовки» в РНК	Документ.РасходнаяНакладная.ТипФасовки → Справочник.экзТипыФасовки
«Количество мест»	КоличествоМест (вкладка «Данные для печати» → «Дополнительные», страница ГруппаДанныеДляПечатиСтраницаДополнительные)
Организация / Подразделение / Весовая / Склад	Организация, ПодразделениеОрганизации, Весовая, Склад
Пункт разгрузки / Получатель	ПунктРазгрузки («Пункт разгрузки (Контрагент)»), Получатель («Контрагент (Получатель)»)
Вкладка «Данные для печати»	страница формы ГруппаДанныеДляПечати
Полные права	роль ПолныеПрава
Весовщики	роль Весовая_Весовщик (и при необходимости Весовая_ВесовщикRLS)
Обмен с БЭКЗ	план обмена агк_ОбменВесоваяБЭКЗ (в составе есть Document.РасходнаяНакладная)
Существующий справочник экзТара	не использовать: это «Тара» (номенклатура/вес), уже связан реквизитом экзТипыФасовки.Тара. Номерная тара — отдельный объект

Предлагаемые имена новых объектов (префикс экз — по домену фасовки/тары; PREFIX в .dev.env пуст):

Назначение	Имя метаданных	Синоним
Признак в типе фасовки	экзТипыФасовки.НомернаяТара	Номерная тара
Справочник экземпляров	Справочник.экзНомернаяТара	Номерная тара
Роль учёта	Роль.экзУчетНомернойТары	Учет номерной тары
Регистр накопления	РегистрНакопления.экзУчетНомернойТары	Учет номерной тары
ТЧ документа	РасходнаяНакладная.УчетНомернойТары	Учет номерной тары
Настройка	Константа.экзИспользоватьОстаткиНомернойТары	Использовать остатки номерной тары
Документ прихода (этап 2)	Документ.экзПриходНомернойТары	Приход номерной тары

Имена допускается скорректировать при реализации при согласовании, смысл и связи — по таблицам ниже.

---

3. Объём работ по этапам

Этап A — к 07.10.2026 (обязательный)

Пункты постановки 1–5: признак в типе фасовки, справочник номерной тары (+ загрузка Excel), регистр, доработка РНК (форма, проверки, движения), настройка «Использовать остатки…» (заготовка под будущее).

Этап B — позже (не до 07.10.2026)

Пункт постановки 6: документ «Приход номерной тары», отчёт о движении номерной тары, включение отбора выбора в РНК по остаткам при включённой настройке.

---

4. Требования к метаданным и правам

4.1. Справочник экзТипыФасовки (Типы фасовки)

Добавить реквизит:

Свойство	Значение
Имя	НомернаяТара
Синоним	Номерная тара
Тип	Булево
По умолчанию	Ложь
Размещение на форме	форма элемента ФормаЭлементаУправляемая

Права на реквизит:

• просмотр — всем ролям, имеющим доступ к справочнику;
• изменение — только роль ПолныеПрава (остальным — только просмотр значения).

Не путать с существующим реквизитом Тара (СправочникСсылка.экзТара).

4.2. Справочник экзНомернаяТара (Номерная тара)

Свойство	Значение
Владелец	Справочник.экзТипыФасовки
Использование подчинения	Элементам
Наименование	строка, длина 25
Код	по принятому в проекте шаблону справочников (допустимо короткий код / автонумерация)
Иерархия	нет

Права:

Действие	Кто
Просмотр / чтение	всем (как минимум ролям контура весовой с доступом к НСИ)
Добавление / изменение / пометка удаления	новая роль экзУчетНомернойТары («Учет номерной тары») + ПолныеПрава

Роль включить в нужные профили групп доступа отдельно (вне кода — администрирование).

4.2.1. Загрузка из Excel

Нужна обработка (отдельная обработка или команда формы списка справочника) загрузки элементов по выбранному владельцу (Тип фасовки):

• пользователь выбирает тип фасовки (владелец) и файл Excel;
• в файле — колонка с наименованием номерной тары (длина ≤ 25); при необходимости — доп. колонки по согласованию на реализации;
• создаются/обновляются элементы с указанным владельцем;
• дубли по наименованию в рамках владельца: не создавать повторно (или обновлять существующий — зафиксировать в реализации один вариант и описать в справке);
• ошибки строк (пустое имя, длина > 25) — в протокол загрузки, без «тихого» пропуска без отчёта.

4.3. Регистр накопления экзУчетНомернойТары

Свойство	Значение
Вид	Остатки
Синоним	Учет номерной тары

Измерения:

Имя	Тип
Организация	СправочникСсылка.Организации
Подразделение	СправочникСсылка.ПодразделенияОрганизаций (из шапки РНК — ПодразделениеОрганизации)
Весовая	СправочникСсылка.Весовые
Склад	СправочникСсылка.Склады
Контрагент	СправочникСсылка.Контрагенты
ТипФасовки	СправочникСсылка.экзТипыФасовки
НомернаяТара	СправочникСсылка.экзНомернаяТара

Ресурс: Количество (Число; для движений РНК — всегда 1 на строку ТЧ).

Регистраторы (этап A):

• Документ.РасходнаяНакладная — вид движения Расход.

Регистраторы (этап B):

• Документ.экзПриходНомернойТары — вид движения Приход (позже).

Контроль уникальности измерений при проектировании: одна комбинация измерений — один остаток; повтор одной и той же номерной тары в одной РНК не допускается (проверка при записи/проведении).

4.4. Настройка экзИспользоватьОстаткиНомернойТары

Свойство	Значение
Тип	Булево
Синоним	Использовать остатки номерной тары
Значение по умолчанию	Ложь
Размещение	форма констант / настройки учёта (по аналогии с другими Использовать… в конфигурации)

Поведение на этапе A: константа создаётся и сохраняется; в форме выбора номерной тары в РНК не отбираем по остаткам — показываем все элементы по владельцу ТипФасовки.

Поведение на этапе B (после документа прихода): при Истина в выборе ТЧ РНК — только тара с положительным остатком по релевантным измерениям (уточнить разрез отбора в задаче этапа B).

---

5. Доработка документа РасходнаяНакладная

5.1. Табличная часть УчетНомернойТары

Колонка	Тип	Обязательность
НомернаяТара	СправочникСсылка.экзНомернаяТара	да, когда ТЧ обязательна по п. 5.3

Дополнительные колонки на этапе A не требуются.

5.2. Форма документа — видимость вкладки

На форме документа (ФормаДокумента):

1. Добавить страницу (вкладку) «Учет номерной тары» справа от «Данные для печати» (ГруппаДанныеДляПечати) в том же наборе страниц, где она расположена для основного сценария РНК.
2. По умолчанию в новом документе вкладка/ТЧ скрыты.
3. При открытии существующего документа: если ТЧ УчетНомернойТары не пустая — показать вкладку.
4. Динамически показывать вкладку при выполнении условий п. 5.3 (изменение ТипФасовки / признака / КоличествоМест).

5.3. Условие обязательности и синхронизация строк

Условие «режим номерной тары»:

• ТипФасовки заполнен;
• у выбранного типа фасовки НомернаяТара = Истина.

Тогда:

1. Вкладка «Учет номерной тары» видима.
2. Число строк ТЧ должно быть равно КоличествоМест (целое; при КоличествоМест ≤ 0 — режим не считать корректным: запретить проведение с понятным сообщением либо не включать обязательность — зафиксировать на реализации: рекомендация — при режиме номерной тары КоличествоМест должно быть ≥ 1).
3. При изменении КоличествоМест — подогнать число строк ТЧ (добавить пустые / удалить лишние с конца; не затирать уже выбранные значения без необходимости).
4. Заполнение всех строк ТЧ обязательно для записи/проведения (проверка заполнения НомернаяТара в каждой строке).
5. Выбор НомернаяТара — только элементы с владельцем = Объект.ТипФасовки (параметр выбора / отбор).
6. Дубли одной и той же ссылки номерной тары в ТЧ одного документа — запретить.

Если условие режима не выполняется:

• вкладку скрывать (если ТЧ пустая);
• если пользователь сменил тип фасовки так, что признак снят, а ТЧ была заполнена — очистить ТЧ с предупреждением или запросить подтверждение (предпочтительно: предупреждение + очистка при смене владельца/признака).

5.4. Проведение — движения по регистру экзУчетНомернойТары

При проведении РНК в режиме номерной тары (п. 5.3) для каждой строки ТЧ формировать движение Расход:

Поле регистра	Источник
Организация	шапка Организация
Подразделение	шапка ПодразделениеОрганизации
Весовая	шапка Весовая
Склад	шапка Склад
Контрагент	если заполнен ПунктРазгрузки — он; иначе Получатель
ТипФасовки	шапка ТипФасовки
НомернаяТара	строка ТЧ НомернаяТара
Количество	1

Если режим номерной тары выключен — движений по этому регистру не писать (и очищать набор записей регистратора).

5.5. Отмена проведения, пометка удаления, перепроведение

• При отмене проведения и при пометке на удаление — движения по экзУчетНомернойТары должны быть сняты (стандартный механизм набора записей регистратора / Движения.Записывать).
• Запись движений всегда через набор записей документа-регистратора с предварительной очисткой, чтобы повторное проведение или правка ТЧ не дублировали остатки.
• Контроль отрицательных остатков на этапе A не обязателен (остатки появятся после документа прихода); при необходимости — мягкое предупреждение, не блок (уточняется при внедрении).

5.6. Обмен с БЭКЗ

Требование: данные по номерной таре не выгружаем в БЭКЗ (пока).

Следствия для этапа A:

1. Новые объекты (экзНомернаяТара, регистр, ТЧ) не включать в состав выгрузки агк_ОбменВесоваяБЭКЗ / правила обмена как обязательную выгрузку.
2. Редактирование только ТЧ УчетНомернойТары (и связанных служебных изменений, не влияющих на состав обмена) не должно регистрировать РасходнаяНакладная к обмену в агк_ОбменВесоваяБЭКЗ.

Техническая реализация (на выбор при кодировании, с фиксацией в коде):

• исключение реквизитов/ТЧ из правил регистрации изменений; и/или
• при записи, если изменены только «игнорируемые» данные номерной тары — ОбменДанными.Получатели.АвтоЗаполнение = Ложь / снятие регистрации по узлам плана; и/или
• доработка правил регистрации плана обмена.

Критерий приёмки К6 обязателен.

---

6. Этап B (отложено): приход и отчёт

Описать отдельно; краткий каркас:

6.1. Документ экзПриходНомернойТары

• Состав реквизитов/ТЧ зеркален измерениям регистра + ресурс Количество (или ТЧ с номерной тарой по аналогии с РНК).
• Регистратор регистра экзУчетНомернойТары, движение Приход.
• Права: как у весовщиков на РНК / Приход по весовой (Весовая_Весовщик и связанные роли).

6.2. Отчёт «Движение номерной тары»

• Анализ прихода/расхода/остатков по регистру экзУчетНомернойТары.
• Детали — в отдельной задаче.

6.3. Включение отбора по остаткам в РНК

• При экзИспользоватьОстаткиНомернойТары = Истина — в выборе ТЧ РНК показывать только тару с остатком.

---

7. Сценарии проверки (этап A)

1. Тип фасовки без признака → в новой РНК вкладки номерной тары нет; проведение без ТЧ ОК.
2. Тип фасовки с признаком, КоличествоМест = 3 → вкладка видна, 3 строки, без заполнения проведение запрещено.
3. Выбор номерной тары другого владельца невозможен.
4. Заполнение 3 разных экземпляров → проведение создаёт 3 движения расхода с Количество = 1 и корректными измерениями (контрагент: приоритет ПунктРазгрузки).
5. Отмена проведения → остатки/обороты регистратора обнулены; повторное проведение не удваивает.
6. Изменение только ТЧ номерной тары у уже выгружаемого/регистрируемого контура → нет новой регистрации в агк_ОбменВесоваяБЭКЗ (при прочих неизменных полях обмена).
7. Загрузка Excel по выбранному типу фасовки создаёт элементы с владельцем и длиной имени ≤ 25.
8. Роль без ПолныеПрава не меняет признак НомернаяТара у типа фасовки; роль экзУчетНомернойТары может создавать элементы справочника номерной тары.

---

8. Вне объёма этапа A

• Документ «Приход номерной тары».
• Отчёт о движении номерной тары.
• Отбор выбора в РНК строго по остаткам.
• Выгрузка номерной тары / движений в БЭКЗ.
• Мобильный клиент / отдельные РМ (если появятся — отдельная задача).

---

9. Открытые решения (зафиксировать при реализации, если не оговорено иначе)

Тема	Рекомендация по умолчанию
Имена метаданных	префикс экз… по таблице §2
КоличествоМест = 0 при включённом признаке	запрет проведения
Дубли в Excel	пропуск с записью в протокол
Отрицательные остатки на этапе A	не блокировать
Место команды загрузки Excel	форма списка экзНомернаяТара

---

10. Порядок реализации (рекомендуемый)

1. Реквизит НомернаяТара в экзТипыФасовки + права.
2. Справочник экзНомернаяТара + роль + загрузка Excel.
3. Регистр экзУчетНомернойТары + константа.
4. ТЧ и форма РНК (видимость, число строк, отбор выбора, проверки).
5. Движения при проведении / отмене.
6. Исключение влияния ТЧ на регистрацию БЭКЗ.
7. Регрессионные сценарии §7.

---

Источники уточнения имён: MCP user-1c (конфигурация ВесоваяАК 0.0.3.21), исходники ves2020 (экзТипыФасовки, РасходнаяНакладная, агк_ОбменВесоваяБЭКЗ, роли ПолныеПрава / Весовая_Весовщик).