1. Идентификация объекта
| Параметр | Значение |
|---|---|
| Тип объекта | Документ (Documents) |
| Имя | ЭлектронныйДокументВС |
| Полное имя | Документ.ЭлектронныйДокументВС |
| Синоним | «Электронный документ ВС» (в некоторых интерфейсах — «Электронный документ (виртуальный склад)») |
| Конфигурация | Управление торговлей для Казахстана, ред. 3.4.5.21 |
| Подсистема | ЭДО (электронный документооборот) / Виртуальный склад |
| Нумерация | Тип Строка, длина 30, периодичность — Год |
| Пользователь | Бухгалтер / менеджер |
| Где найти | Раздел «ЭДО»; навигационная ссылка: e1cib/list/Документ.ЭлектронныйДокументВС |
Назначение. Документ реализует юридически значимый электронный документооборот с органами государственных доходов РК (КГД) в рамках модуля «Виртуальный склад» (ВС) и оформления СНТ (сопроводительных накладных на товары). Хранит реквизиты отправителя/получателя, склады-участники перемещения, тип формы, причину списания, статус жизненного цикла и ЭЦП. Служит для формирования, подписания ЭЦП и обмена электронными документами ВС/СНТ через инфраструктуру ИС ЭСФ. В учётном контуре документ ведёт оперативный учёт остатков виртуального склада (движения по регистрам накопления), а не бухгалтерские проводки Дт/Кт.
Виртуальный склад — механизм КГД РК для контроля движения товаров из «Перечня изъятий» и подакцизных товаров; остатки ВС ведутся отдельно от складского учёта конфигурации и синхронизируются с кабинетом налогоплательщика.
2. Реквизиты и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обяз. | Назначение |
|---|---|---|---|
Организация |
СправочникСсылка.Организации | Да | Юрлицо, от имени которого оформляется документ. Подставляется основная организация из настроек. |
ТипФормы |
ПеречислениеСсылка.ТипыФормВС | Да | Тип формы ВС/СНТ (перемещение, списание, ввоз, возврат и т. п.). Определяет логику заполнения и движений. |
ПричинаСписания |
ПеречислениеСсылка.ПричинаСписанияВС | Да | Причина списания товара с виртуального склада. |
ВидДетализации |
ПеречислениеСсылка.ВидДетализации | Да | Уровень детализации данных документа. |
СкладОтправитель |
СправочникСсылка.ВиртуальныеСклады | Да | ВС-отправитель, откуда списывается товар. Должен отличаться от склада-получателя. |
СкладПолучатель |
СправочникСсылка.ВиртуальныеСклады | Да | ВС-получатель, куда приходит товар. Должен отличаться от склада-отправителя. |
СкладОтправительИдентификатор |
Число | Нет | Идентификатор склада-отправителя в ИС КГД. |
СкладОтправительНаименование |
Строка | Нет | Наименование склада-отправителя (как в ИС). |
СкладПолучательИдентификатор |
Число | Нет | Идентификатор склада-получателя в ИС КГД. |
СкладПолучательНаименование |
Строка | Нет | Наименование склада-получателя (как в ИС). |
ОтправительИдентификатор |
Строка | Нет | БИН/ИИН отправителя. |
ОтправительНаименование |
Строка | Нет | Наименование отправителя. |
ОтправительАдрес |
Строка | Нет | Адрес отправителя. |
ПолучательИдентификатор |
Строка | Нет | БИН/ИИН получателя. |
ПолучательНаименование |
Строка | Нет | Наименование получателя. |
ПолучательАдрес |
Строка | Нет | Адрес получателя. |
ДатаИсходногоДокумента |
Дата | Нет | Дата исходного (первичного) документа. |
РегистрационныйНомер |
Строка | Нет | Регистрационный номер, присвоенный в ИС КГД. |
Идентификатор |
Строка | Нет | Уникальный идентификатор документа в ИС. |
ВерсияУТТН |
Число | Нет | Версия формата УТТН/СНТ. |
Статус |
ПеречислениеСсылка.СтатусыУТТН | Нет | Статус документа в жизненном цикле (черновик, отправлен, подтверждён, отозван и т. п.). |
ТипПодписи |
ПеречислениеСсылка.ТипыПодписиЭСФ | Нет | Тип используемой ЭЦП. |
ЭЦП |
Строка | Нет | Значение электронной цифровой подписи. |
ОбщаяСуммаТоваров |
Число | Нет | Итоговая сумма товаров документа, ₸. |
ОбщаяСуммаИсходныхТоваров |
Число | Нет | Сумма товаров по исходному документу, ₸. |
Причина |
Строка | Нет | Текстовое описание причины (дополнение к ПричинаСписания). |
КорректировкаИП |
Булево | Нет | Признак корректировки индивидуального предпринимателя. |
ДокументОснование |
ДокументСсылка | Нет | Документ-основание при вводе «на основании». |
Комментарий |
Строка | Нет | Произвольный комментарий. |
2.2 Табличные части
Документ содержит табличную часть со строками товаров (номенклатура, количество, единицы, сумма, коды ТН ВЭД/ГСВС), суммы которых агрегируются в ОбщаяСуммаТоваров и служат источником движений по регистрам виртуального склада. Точный состав колонок ТЧ версионно-специфичен и уточняется по метаданным конкретной сборки 3.4.5.21.
По суммам НДС (РК 2026). Если строки товаров содержат налоговые показатели, ставка НДС — 16 % (базовая ставка 2026 года). Значение 12 % относится к периоду до 2026 г. и в текущей конфигурации не применяется.
3. Формы
| Форма | Назначение |
|---|---|
| ФормаДокумента | Основная форма для ввода/просмотра: шапка (организация, склады, отправитель/получатель), табличная часть товаров, статус и панель работы с ЭЦП/отправкой в ИС. |
| ФормаСписка | Список документов ВС раздела «ЭДО» с отбором по организации, статусу, складам и периоду. Открывается по e1cib/list/Документ.ЭлектронныйДокументВС. |
| ФормаВыбора | Выбор документа из других объектов (например, при заполнении реквизита-основания). |
Перечень форм — типовой для документа ЭДО; специализированные формы подписания/просмотра ЭЦП реализуются через общие механизмы подсистемы ЭСФ/ВС.
4. Ключевые процедуры модулей
Факты ниже получены статическим анализом BSL-модулей объекта (без выполнения кода); имена обработчиков — дословно из выгрузки.
Модуль объекта (ObjectModule)
| Обработчик | Объём | Что делает |
|---|---|---|
ОбработкаПроведения |
4 стр. | Формирует движения документа. Делегирует построение движений в общий модуль ЭСФСерверПовтИсп; фактические записи ложатся в регистры товаров виртуального склада (см. раздел 5). |
ОбработкаУдаленияПроведения |
4 стр. | Отменяет движения при отмене проведения (очистка наборов записей регистров). |
ОбработкаПроверкиЗаполнения |
4 стр. | Контроль заполнения обязательных реквизитов (Организация, СкладОтправитель, СкладПолучатель, ТипФормы, ПричинаСписания, ВидДетализации) и логических условий (склад-отправитель ≠ склад-получатель). |
ПередЗаписью |
4 стр. | Предзаписная подготовка: досчёт сумм/статусов, служебные проверки перед сохранением. |
ОбработкаЗаполнения |
4 стр. | Первичное заполнение при создании и при вводе «на основании» (перенос реквизитов из документа-основания). |
ПриКопировании |
38 стр. | Логика копирования: очистка идентификаторов ИС (Идентификатор, РегистрационныйНомер, ЭЦП), сброс статуса и признаков, чтобы копия не наследовала «серверную» привязку исходного документа. |
Зависимости от общих модулей
ЭСФСерверПовтИсп(6 вызовов) — серверная логика ЭСФ/ВС с повторным использованием: формирование движений, работа со структурами ИС ЭСФ, кэшируемые справочные данные.ВСКлиентСервер(3 вызова) — клиент-серверные функции модуля «Виртуальный склад»: разбор/сборка структур ВС, проверки, вспомогательные преобразования.
5. Проведение и движения
Конфигурация торговая — документ ведёт оперативный учёт, а не проводки Дт/Кт. При проведении ОбработкаПроведения формирует движения по двум регистрам накопления:
| Регистр | Тип | Смысл движения |
|---|---|---|
РегистрНакопления.ТоварыВиртуальногоСкладаВРезерве |
Накопления (остатки) | Резервирование товара на виртуальном складе под операцию (приход/расход резерва). |
РегистрНакопления.ТоварыНаВиртуальныхСкладах |
Накопления (остатки) | Основной учёт остатков товара на ВС: списание со склада-отправителя и приход на склад-получатель. |
Логика движений. По складу-отправителю формируется расход (Расход) по ТоварыНаВиртуальныхСкладах, по складу-получателю — приход (Приход); резерв корректируется через ТоварыВиртуальногоСкладаВРезерве. Состав и знак движений зависят от ТипФормы и ПричинаСписания.
Сопоставление с бухгалтерским контуром (РК)
Сам документ ВС бухгалтерских проводок не делает. Соответствующие им операции реализации/перемещения/списания, оформляемые смежными документами УТ для КЗ по типовому плану счетов РК, укрупнённо:
| Операция | Дебет | Кредит |
|---|---|---|
| Реализация товаров (доход) | 1210 «Краткосрочная ДЗ покупателей» | 6010 «Доход от реализации» |
| НДС при реализации (16 %) | 1210 | 3130 «НДС к уплате» |
| Списание себестоимости | 7010 «Себестоимость реализации» | 1330 «Товары» |
| Поступление оплаты | 1030 «Деньги на текущих счетах» | 1210 |
| Расчёты с поставщиком | 1330 | 3310 «КЗ поставщикам» |
Проводки приведены как ориентир соответствия оперативных операций плану счетов РК; сам
ЭлектронныйДокументВСих не формирует.
6. Связанные объекты и ввод на основании
- Виртуальные склады (
Справочник.ВиртуальныеСклады) — источник дляСкладОтправитель/СкладПолучатель. - Перечисления:
ТипыФормВС,ПричинаСписанияВС,ВидДетализации,СтатусыУТТН,ТипыПодписиЭСФ— управляют типом, статусом и подписью. - Документы ЭСФ/СНТ — сопряжённые электронные документы;
ЭлектронныйДокументВСможет вводиться на основании документа реализации/перемещения (реквизитДокументОснование) и, в свою очередь, служить основанием для ЭСФ. - Общие модули
ЭСФСерверПовтИсп,ВСКлиентСервер— сервисный слой обмена с ИС ЭСФ и модулем ВС.
Ввод на основании. Реквизит ДокументОснование и обработчик ОбработкаЗаполнения обеспечивают перенос организации, складов и данных отправителя/получателя из документа-основания. Конкретный перечень объектов-оснований задаётся командами ввода на основании в метаданных сборки.
7. Точки расширения
- Обработчики модуля объекта (
ОбработкаПроведения,ОбработкаЗаполнения,ОбработкаПроверкиЗаполнения,ПередЗаписью,ПриКопировании) — расширяются через Расширение конфигурации аннотациями&Вместо/&Перед/&После. Для правки движений предпочтителен&После ОбработкаПроведенияс корректировкой наборов записей регистров ВС. - Общие модули
ЭСФСерверПовтИспиВСКлиентСервер— точки влияния на формирование движений и обмен с ИС; переопределяются в расширении с осторожностью (ПовтИспкэширует результаты в рамках сеанса/вызова). - Формы — программные события
ПриСозданииНаСервере,ПередЗаписьюНаСервере, команды подписания ЭЦП/отправки расширяются через расширение формы. - Подписки на события — для сквозной логики (проверки, интеграции) вместо правки модуля объекта.
- Дополнительные реквизиты/сведения (механизм БСП) — для хранения нестандартных атрибутов без изменения метаданных.
Версионно-специфично (требует проверки на сборке 3.4.5.21): точный состав колонок табличной части товаров, полный перечень значений перечислений
ТипыФормВС/ПричинаСписанияВСи конкретный набор документов-оснований в командах ввода «на основании».