1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Документ (Documents.ПланПродажПоКатегориям) |
| Имя | ПланПродажПоКатегориям |
| Синоним | «План продаж по категориям» |
| Конфигурация | Управление торговлей для Казахстана, редакция 3.4 (3.4.5.21) |
| Подсистема | Планирование (товарное планирование) |
| Нумерация | Тип Строка, длина 11, непериодическая (Nonperiodical) |
| Навигационная ссылка | e1cib/list/Документ.ПланПродажПоКатегориям |
Назначение. Документ формирует план продаж в разрезе товарных категорий на заданный период. Является источником плановых данных для подсистемы планирования: по нему выполняется сопоставление «план — факт», рассчитывается выполнение плана и формируется обеспечение потребностей. Работают с документом планировщик/аналитик; раздел интерфейса — «Планирование» (в некоторых поставках доступен через служебные подсистемы).
Важно. Это документ оперативного (управленческого) учёта торговой конфигурации. Он не формирует бухгалтерские проводки Дт/Кт и не порождает налоговых движений (НДС, ЭСФ/СНТ). Плановые суммы задаются в тенге (₸); если план строится в суммовом выражении с учётом НДС, применяется действующая для РК 2026 ставка 16 % (не 12 %). Фактические же документы реализации (по которым план сравнивается с фактом) уже отражают выручку по счёту 6010, себестоимость — 7010, НДС к уплате — 3130, расчёты с покупателями — 1210.
2. Реквизиты шапки и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обяз. | Назначение |
|---|---|---|---|
Подразделение |
СправочникСсылка.СтруктураПредприятия | Да | Подразделение, к которому относится план (аналитика планирования). |
Статус |
ПеречислениеСсылка.СтатусыПланов | Да | Статус в жизненном цикле плана (черновик / в работе / утверждён и т. п.). |
Периодичность |
ПеречислениеСсылка.Периодичность | Да | Шаг детализации плана (день/неделя/месяц/квартал…). |
НачалоПериода |
Дата | Да | Начало планируемого периода. |
ОкончаниеПериода |
Дата | Да | Окончание планируемого периода. |
Сценарий |
СправочникСсылка.СценарииТоварногоПланирования | Да | Сценарий планирования, к которому относится план. |
ВидПлана |
СправочникСсылка.ВидыПланов | Да | Вид плана (классификация плана). |
ФорматМагазина |
СправочникСсылка.ФорматыМагазинов | Да | Формат магазина, для которого строится план. |
Склад |
СправочникСсылка.Склады | Да | Склад, определяющий разрез плановых показателей. |
СтатьяБюджетов |
Строка | Да | Статья бюджетов для отражения в бюджетировании. |
СценарийБюджетирования |
Строка | Да | Сценарий бюджетирования. |
ЗаполненоАвтоматически |
Булево | Нет | Признак автоматического заполнения плана. |
ЗаполнятьПоФормуле |
Булево | Нет | Признак заполнения показателей по формуле. |
ОбновитьДополнить |
Число | Нет | Режим пересчёта: обновить/дополнить существующие значения. |
ИзменитьРезультатНа |
Число | Нет | Корректирующий коэффициент/величина изменения результата. |
ТочностьОкругления |
Число | Нет | Точность округления рассчитанных показателей. |
КроссТаблица |
Булево | Нет | Режим ввода/представления данных в виде кросс-таблицы. |
Замещающий |
Булево | Нет | План замещает ранее введённые плановые данные. |
ОтражаетсяВБюджетировании |
Булево | Нет | Признак отражения плана в подсистеме бюджетирования. |
Назначение |
СправочникСсылка.Назначения | Нет | Обособление плана под конкретный заказ/деятельность. |
ПользовательскиеНастройки |
ValueStorage | Нет | Сохранённые пользовательские настройки заполнения. |
СтруктураНастроек |
ValueStorage | Нет | Служебная структура настроек документа. |
Ответственный |
СправочникСсылка.Пользователи | Нет | Ответственный за документ. |
Комментарий |
Строка | Нет | Произвольный комментарий. |
2.2 Табличные части
ТоварныеКатегории — основная табличная часть, содержит плановые показатели в разрезе категорий (10 колонок).
| Имя | Тип | Назначение |
|---|---|---|
ТоварнаяКатегория |
СправочникСсылка.ТоварныеКатегории | Товарная категория, по которой задаётся план. |
РейтингПродаж |
СправочникСсылка.РейтингиПродажНоменклатуры | Рейтинг продаж номенклатуры внутри категории. |
| (прочие колонки) | Число / Ссылка | Плановые количественные и суммовые показатели по строке (объём, сумма плана и т. п.). |
Полный состав колонок табличной части (плановое количество, плановая сумма, доля и др.) фиксируется конкретной поставкой — требует проверки в конфигураторе для точных имён показателей.
3. Формы
Для документа этого вида в типовой поставке предусмотрены:
- ФормаДокумента — основная форма ввода: шапка (период, сценарий, вид плана, формат, склад) и табличная часть
ТоварныеКатегории; кнопки заполнения (автозаполнение, заполнение по формуле, режим кросс-таблицы). - ФормаСписка — список планов продаж по категориям с отборами по сценарию/периоду/статусу; открывается по ссылке
e1cib/list/Документ.ПланПродажПоКатегориям. - ФормаВыбора — выбор документа в поля других объектов.
- Печатные формы — формируются через
УправлениеПечатью(см. раздел 4); печать плана.
4. Ключевые процедуры модулей
Факты из статического анализа BSL-модулей объекта (без выполнения кода). Имена — дословно из выгрузки.
4.1 Модуль объекта (ObjectModule)
| Обработчик | Объём | Назначение |
|---|---|---|
ОбработкаПроведения |
12 стр. | Формирует движения при проведении; делегирует расчёт в общие модули ПроведениеСерверУТ и Планирование. |
ОбработкаУдаленияПроведения |
9 стр. | Отменяет/очищает движения при отмене проведения. |
ОбработкаПроверкиЗаполнения |
85 стр. | Контроль корректности заполнения (обязательные реквизиты, согласованность периода, сценария, показателей). Наиболее объёмный обработчик — основная бизнес-валидация. |
ПередЗаписью |
33 стр. | Подготовка данных перед записью (пересчёт, синхронизация настроек). |
ПриЗаписи |
12 стр. | Действия при записи объекта. |
ОбработкаЗаполнения |
8 стр. | Заполнение по умолчанию при создании/вводе на основании. |
ПриКопировании |
12 стр. | Корректная инициализация полей при копировании документа. |
4.2 Зависимости от общих модулей
Планирование (15 вызовов) и ПроведениеСерверУТ (11) — основная логика проведения и планирования; далее ОбщегоНазначения (5), ОбщегоНазначенияУТ (4), УправлениеПечатью (4), Пользователи (3), ОбщегоНазначенияКлиентСервер (2), ПланированиеКлиентСерверПовтИсп (2), ОценкаПроизводительности (2), ПланированиеКлиентСервер (1), ЗначениеНастроекПовтИсп (1), ФормированиеПечатныхФорм (1), ШтрихкодированиеПечатныхФорм (1), ОбщегоНазначенияУТКлиентСервер (1), СтроковыеФункцииКлиентСервер (1).
4.3 Контроль и сообщения
В коде используется формирование текста исключения (ТекстИсключения) — при ошибках проверки заполнения/проведения пользователю выдаётся диагностическое сообщение.
5. Проведение и движения
Документ ведёт оперативный учёт и при проведении формирует движения по регистру накопления (не бухгалтерские проводки):
| Регистр | Вид | Роль |
|---|---|---|
AccumulationRegister.ПланыПродажПоКатегориям |
Накопления | Хранит плановые показатели продаж в разрезе товарных категорий; используется для анализа «план — факт» и формирования обеспечения. |
Логика:
ОбработкаПроведениявызывает серверные процедурыПроведениеСерверУТиПланирование, которые по данным шапки (сценарий, период, склад, формат) и табличной частиТоварныеКатегориирассчитывают набор записей регистра.- Записи формируются с ключевыми измерениями плана (сценарий, период/периодичность, подразделение/склад, товарная категория) и ресурсами (плановое количество/сумма).
ОбработкаУдаленияПроведенияочищает эти движения при отмене проведения.
Так как это плановый документ, он не создаёт проводок по счетам РК (1210/1030/1330/3310/3130/6010/7010) и не формирует ЭСФ/СНТ — эти движения возникают у фактических документов реализации, с которыми план впоследствии сравнивается.
6. Связанные объекты и ввод на основании
СценарииТоварногоПланирования,ВидыПланов,ФорматыМагазинов,ТоварныеКатегории,РейтингиПродажНоменклатуры— справочники-источники аналитики плана.AccumulationRegister.ПланыПродажПоКатегориям— регистр-приёмник движений.- Подсистема бюджетирования — при установленном
ОтражаетсяВБюджетированииплан участвует в бюджетах (поСтатьяБюджетов/СценарийБюджетирования). - Документы обеспечения/заказов — план служит основанием для расчёта потребностей и обеспечения в подсистеме планирования.
ОбработкаЗаполненияподдерживает заполнение при вводе на основании (например, из другого планового документа или сценария планирования).
7. Точки расширения
- Модуль объекта: подписки/расширения обработчиков
ОбработкаПроведения,ОбработкаПроверкиЗаполнения,ПередЗаписью,ОбработкаЗаполнения— для дополнительной валидации и правил формирования движений. - Расширение конфигурации: добавление реквизитов/колонок табличной части
ТоварныеКатегориии заимствование форм для новых показателей плана. - Общие модули
Планирование/ПланированиеКлиентСервер— переопределяемые процедуры логики автозаполнения и заполнения по формуле. - Печать: механизм
УправлениеПечатью/ФормированиеПечатныхФорм— регистрация дополнительных печатных форм. - Подписки на события записи документа для интеграции с бюджетированием и обеспечением.