В конфигурации «Управление торговлей для Казахстана» 3.4.5.21 документ «ПланОстатков» предназначен для формирования целевых остатков товаров по складу, номенклатуре и плановому периоду.
1. Идентификация объекта
| Параметр | Значение |
|---|---|
| Тип объекта | Документ (Document) |
| Имя | ПланОстатков |
| Полное имя | Документ.ПланОстатков |
| Синоним | «План остатков» |
| Конфигурация | Управление торговлей для Казахстана 3.4.5.21 |
| Подсистема | Планирование (раздел «Планирование» / «Служебные подсистемы») |
| Тип нумерации | Строка, длина 11, непериодическая (Nonperiodical) |
| Где найти | Раздел «Планирование» → «План остатков». Навигационная ссылка: e1cib/list/Документ.ПланОстатков |
Назначение. Документ формирует план целевых остатков товаров на складах на заданный период. Используется в подсистеме планирования: по нему выполняется сопоставление плана с фактом и рассчитывается обеспечение потребностей. Основные пользователи — планировщик и аналитик по товарным запасам.
Это документ оперативного управленческого планирования. При проведении он отражает плановые показатели в регистрах конфигурации. Фактические поступления, реализации и оплаты оформляются отдельными документами хозяйственных операций.
2. Реквизиты шапки и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обяз. | Назначение |
|---|---|---|---|
| Статус | ПеречислениеСсылка.СтатусыПланов | Да | Статус документа в жизненном цикле: черновик, в работе, утверждён и другие состояния. Управляет постановкой плана на контроль. |
| Периодичность | ПеречислениеСсылка.Периодичность | Да | Периодичность планирования: день, неделя, месяц и другие варианты. Определяет шаг детализации плана. |
| НачалоПериода | Дата | Да | Начало планового периода. |
| ОкончаниеПериода | Дата | Да | Окончание планового периода. |
| Ответственный | СправочникСсылка.Пользователи | Нет | Пользователь, ответственный за документ. |
| ОбновитьДополнить | Число | Нет | Служебный параметр режима заполнения: обновление или дополнение существующих строк. |
| ИзменитьРезультатНа | Число | Нет | Величина корректировки планового результата при пересчёте. |
| ТочностьОкругления | Число | Нет | Точность округления рассчитываемых плановых значений. |
| ПользовательскиеНастройки | ХранилищеЗначения | Нет | Сохранённые пользовательские настройки формы и заполнения. |
| Комментарий | Строка | Нет | Произвольный комментарий. |
| Сценарий | СправочникСсылка.СценарииТоварногоПланирования | Да | Сценарий товарного планирования, в рамках которого строится план. |
| ВидПлана | СправочникСсылка.ВидыПланов | Да | Вид плана — классификатор назначения документа. |
| ЗаполненоАвтоматически | Булево | Нет | Признак автоматического заполнения табличной части по формуле или данным. |
| Склад | СправочникСсылка.Склады | Да | Склад, по остаткам которого строится план. Определяет измерение движений. |
| КроссТаблица | Булево | Нет | Режим представления и ввода данных в виде кросс-таблицы «номенклатура × периоды». |
| Календарь | СправочникСсылка.ПроизводственныеКалендари | Нет | Производственный календарь для разбивки периода. |
| СтруктураНастроек | ХранилищеЗначения | Нет | Структура настроек формирования плана. |
| ЗаполнятьПоФормуле | Булево | Нет | Признак заполнения плановых показателей по формуле. |
| ОтражаетсяВБюджетировании | Булево | Нет | Признак отражения плана в подсистеме бюджетирования. |
| СтатьяБюджетов | Строка | Да | Статья бюджетов для отражения. |
| СценарийБюджетирования | Строка | Да | Сценарий бюджетирования для отражения. |
| Замещающий | Булево | Нет | Признак замещающего плана, который перекрывает ранее введённый. |
| Назначение | СправочникСсылка.Назначения | Нет | Обособление товаров под конкретный заказ или направление деятельности. |
2.2 Табличная часть «Товары» (12 колонок)
| Имя | Тип | Назначение |
|---|---|---|
| Номенклатура | СправочникСсылка.Номенклатура | Планируемая позиция товара или услуги. |
| Характеристика | СправочникСсылка.ХарактеристикиНоменклатуры | Характеристика номенклатуры, например цвет или размер, когда применяется соответствующий учёт. |
| Упаковка | СправочникСсылка.УпаковкиЕдиницыИзмерения | Упаковка при ведении учёта в упаковках. |
| Количество | Число | Плановое количество в базовой единице измерения. |
| КоличествоУпаковок | Число | Плановое количество в упаковках. |
| Остальные колонки | Реквизиты табличной части | Плановые показатели по периодам, аналитические разрезы и служебные поля обработки строк. |
В описании структуры раскрыты первые пять колонок из двенадцати. Полный состав реквизитов табличной части определяется метаданными объекта Документ.ПланОстатков в конфигурации 3.4.5.21.
3. Формы
Работа с документом организована через формы документа, списка и выбора, а также через элементы настройки заполнения:
- Форма документа — ввод реквизитов шапки, периода, сценария, вида плана и склада, работа с табличной частью «Товары», автоматическое заполнение по формуле и представление данных в виде кросс-таблицы.
- Форма списка — просмотр планов остатков и отбор по сценарию, виду плана и периоду.
- Форма выбора — выбор документа из других объектов конфигурации.
- Элементы настройки заполнения — управление формулой и структурой настроек формирования плана.
Имена и состав подчинённых форм следует определять по ветке «Формы» объекта Документ.ПланОстатков в дереве метаданных конфигурации 3.4.5.21.
4. Ключевые процедуры модуля объекта
Имена обработчиков приведены в соответствии со структурой BSL-модуля объекта ObjectModule:
| Обработчик | Объём | Назначение |
|---|---|---|
| ОбработкаПроведения | 13 строк | Формирует движения при проведении. Делегирует расчёт общим модулям ПроведениеСерверУТ и Планирование. |
| ОбработкаУдаленияПроведения | 9 строк | Очищает движения при отмене проведения. |
| ОбработкаПроверкиЗаполнения | 208 строк | Выполняет основную валидацию: контролирует обязательные реквизиты, период, сценарий, вид плана, склад, табличную часть и согласованность настроек. |
| ПередЗаписью | 41 строка | Подготавливает данные перед записью, пересчитывает служебные поля и контролирует статус. |
| ПриЗаписи | 12 строк | Обновляет зависимые данные планирования при записи. |
| ОбработкаЗаполнения | 15 строк | Заполняет реквизиты по умолчанию при создании документа или вводе на основании. |
| ПриКопировании | 12 строк | Корректирует значения при копировании документа, включая сброс уникальных и статусных полей. |
Контроль и сообщения из кода. При нарушении правил заполнения или проведения обработчики формируют текст исключения.
Зависимости от общих модулей (число вызовов)
Планирование (15), ПроведениеСерверУТ (11), ОбщегоНазначения (6), ОбщегоНазначенияУТ (6), УправлениеПечатью (4), ОбщегоНазначенияКлиентСервер (3), Пользователи (3), ПланированиеКлиентСерверПовтИсп (2), НоменклатураКлиентСервер (2), ОценкаПроизводительности (2), ФормированиеПечатныхФорм (2), ПланированиеКлиентСервер (1), НоменклатураСервер (1), ЗначениеНастроекПовтИсп (1), ШтрихкодированиеПечатныхФорм (1).
Основная бизнес-логика сосредоточена в модуле Планирование, который отвечает за расчёт планов и обеспечения, и в модуле ПроведениеСерверУТ, применяющем унифицированный механизм формирования движений.
5. Проведение и движения
Документ ведёт оперативный учёт плановых показателей посредством движений по регистрам накопления конфигурации.
Движения по регистрам
| Регистр | Тип | Назначение |
|---|---|---|
| РегистрНакопления.ПланыОстатков | Накопления | Основной регистр для хранения целевых остатков товаров по складу, номенклатуре и периоду. Данные используются для сравнения плана с фактом и расчёта обеспечения. |
| РегистрНакопления.ПланыОплатПоставщикам | Накопления | Хранит плановые оплаты поставщикам, связанные с планом пополнения остатков, и используется при планировании денежных потоков. |
Логика проведения. ОбработкаПроведения в модуле объекта передаёт формирование движений общим модулям ПроведениеСерверУТ и Планирование. Они обрабатывают склад, период, сценарий, вид плана и строки табличной части «Товары», после чего записывают рассчитанные плановые показатели в регистры.
Фактические поступления, реализации и оплаты оформляются отдельными документами. Электронные документы по фактическим операциям оформляются в Информационной системе ЭСФ (ИС ЭСФ), виртуальном складе, СНТ.
6. Связанные объекты и ввод на основании
- Сценарии: Справочник.СценарииТоварногоПланирования и Справочник.ВидыПланов задают контекст планирования.
- Аналитика: Справочник.Склады, Справочник.Номенклатура, Справочник.ХарактеристикиНоменклатуры, Справочник.УпаковкиЕдиницыИзмерения и Справочник.Назначения.
- Календарь: Справочник.ПроизводственныеКалендари используется для разбивки планового периода.
- Регистры-потребители: РегистрНакопления.ПланыОстатков и РегистрНакопления.ПланыОплатПоставщикам предоставляют данные для план-фактного анализа, расчёта обеспечения потребностей и планирования оплат.
- Бюджетирование: при установленном признаке ОтражаетсяВБюджетировании план участвует в подсистеме бюджетирования с использованием реквизитов СтатьяБюджетов и СценарийБюджетирования.
- Обработчик ОбработкаЗаполнения выполняет заполнение реквизитов при создании документа и обработке переданных данных другого объекта планирования.
Состав объектов, из которых разрешён ввод документа на основании, определяется настройкой «Ввод на основании» для объекта Документ.ПланОстатков в конфигурации 3.4.5.21.
7. Точки расширения
- Расширение модуля объекта — дополнение обработчика ОбработкаПроверкиЗаполнения собственными правилами контроля плановых показателей и обработчика ОбработкаПроведения дополнительной логикой движений.
- Подписки на события ПередЗаписью и ПриЗаписи документа — подключение интеграций и аудита без изменения основной конфигурации.
- Общие модули — подключение дополнительной логики планирования через предусмотренные конфигурацией программные интерфейсы модуля Планирование.
- Расширение форм — добавление реквизитов и команд в форму документа и форму списка через расширение конфигурации.
- Печать — подключение собственных макетов через механизмы УправлениеПечатью и ФормированиеПечатныхФорм, которые используются документом совместно с механизмом штрихкодирования печатных форм.
8. Вопросы и ответы
Где пользователь открывает документ «План остатков»?
Документ открывается по пути «Планирование» → «План остатков». Для программного перехода к списку используется навигационная ссылка e1cib/list/Документ.ПланОстатков.
Какие данные обязательны для формирования плана?
В карточке документа заполняют статус, периодичность, начало и окончание периода, сценарий товарного планирования, вид плана и склад. Плановые позиции вводят в табличной части «Товары».
Где хранятся результаты проведения?
Целевые остатки записываются в РегистрНакопления.ПланыОстатков. Плановые оплаты поставщикам отражаются в РегистрНакопления.ПланыОплатПоставщикам.
Как документ заполняется автоматически?
Автоматическое заполнение управляется признаками ЗаполнятьПоФормуле и ЗаполненоАвтоматически, а параметры расчёта сохраняются в реквизитах СтруктураНастроек и ПользовательскиеНастройки.
Как безопасно доработать документ?
Дополнительные проверки, команды формы, печатные формы и интеграционную логику следует размещать в расширении конфигурации. Для интеграций подходят подписки на события ПередЗаписью и ПриЗаписи, а для пользовательских команд — расширения формы документа и формы списка.