1. Идентификация объекта
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ВиртуальныеСкладыКонтрагента |
| Полное имя | Справочник.ВиртуальныеСкладыКонтрагента |
| Синоним | не задан (—) |
| Конфигурация | Бухгалтерия для Казахстана, ред. 3.0.74.2 |
| Страна учёта | Республика Казахстан, валюта — тенге (₸) |
| Навигационная ссылка | e1cib/list/Справочник.ВиртуальныеСкладыКонтрагента |
Назначение. Справочник хранит перечень виртуальных (удалённых) складов, принадлежащих контрагентам организации. Применяется в логистических и торговых сценариях электронного документооборота Казахстана: при выписке ЭСФ (электронных счетов-фактур, ИС ЭСФ) и СНТ (сопроводительных накладных на товары) необходимо указывать склад контрагента, идентифицированный в его внешней системе. Каждый виртуальный склад получает уникальный числовой идентификатор (id), под которым он известен во внешней системе контрагента, что обеспечивает корректную API-интеграцию и сопоставление складов при обмене данными.
Где найти в 1С: раздел «Продажа» → «Виртуальные склады контрагентов»; либо через команду «Обновить виртуальные склады» в мастере-помощнике получения данных. Прямая навигация — по ссылке e1cib/list/Справочник.ВиртуальныеСкладыКонтрагента.
2. Реквизиты и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
| Наименование (стандартный) | Строка | Обязательный | Название виртуального склада, отображается в списках и формах выбора. Стандартный реквизит справочника. |
| Контрагент | СправочникСсылка.Контрагенты | Обязательный (ShowError) |
Контрагент-владелец виртуального склада. Без заполнения запись сохранить нельзя — контроль на уровне проверки заполнения. |
| ИдентификаторСклада | Число (xs:decimal) |
Необязательный (DontCheck) |
Уникальный числовой идентификатор (id) склада во внешней системе контрагента. Ключ сопоставления при API-интеграции и обмене ЭСФ/СНТ. |
| Адрес | Строка (xs:string) |
Необязательный (DontCheck) |
Физический адрес склада контрагента. Информационное поле, используется для отображения в документах и печатных формах. |
| Статус | ПеречислениеСсылка | Необязательный (DontCheck) |
Статус активности склада (например, «Активен» / «Заблокирован»). Влияет на возможность выбора склада в документах: заблокированные склады отфильтровываются. |
2.2 Табличные части
Табличных частей нет. Все данные хранятся в реквизитах шапки — справочник плоский, одна запись = один виртуальный склад одного контрагента.
3. Формы
| Форма | Роль | Состав/особенности |
|---|---|---|
| ФормаСписка | Основная форма списка складов | ~41 элемент управления. Содержит команды работы с помощником получения данных и установки основного склада. |
| ФормаЭлемента ⭐ | Создание/редактирование одного склада | ~27 элементов. Поля ввода: Наименование, Адрес, Контрагент, ИдентификаторСклада. Ключевая форма ручного ведения. |
| ФормаВыбора | Выбор склада из списка | ~37 элементов. Поддерживает отбор по Статусу и Контрагенту, содержит команду вызова помощника. Вызывается из документов при подборе склада контрагента. |
4. Ключевые процедуры модулей
Прикладной BSL-код в evidence не приложен, поэтому ниже — типовой набор обработчиков для справочника такого назначения (интеграционного). Конкретные строки/имена уточняются по конфигуратору данной сборки.
Модуль объекта (ОбработкаПроверкиЗаполнения)
- Контроль обязательности реквизита Контрагент (
ShowError): при незаполненном контрагенте запись отклоняется с сообщением пользователю. - Реквизиты
Адрес,ИдентификаторСклада,Статусиз проверки исключены (DontCheck).
Модуль объекта (ПередЗаписью)
- Нормализация/проверка уникальности
ИдентификаторСкладав разрезе контрагента (чтобы один и тот же внешнийidне задваивался при обмене).
Модуль формы элемента
ПриСозданииНаСервере— начальная настройка доступности полей и подстановка статуса по умолчанию.- Обработчики изменения
Контрагент— переустановка отбора и очистка/пересчёт зависимых полей.
Модуль формы списка / выбора
- Команда «Обновить виртуальные склады» — запуск помощника получения данных: обращение к API контрагента, загрузка перечня складов и их идентификаторов, создание/обновление элементов справочника.
- Команда установки основного склада — пометка склада, подставляемого по умолчанию в документы.
- Установка отборов формы выбора по
СтатусиКонтрагент.
Требует проверки (версионно-специфично): точный протокол/адрес API помощника получения данных и алгоритм дедупликации складов могут отличаться между сборками 3.0.7x.
5. Проведение и движения
Справочник не проводится и самостоятельно не формирует движений по регистрам и бухгалтерских проводок — это нормативно-справочная информация (НСИ). Записи создают/меняют движения только косвенно, как аналитика в документах, где склад контрагента указывается.
Данные справочника используются в документах реализации/поступления и электронного документооборота (ЭСФ/СНТ). При проведении таких документов формируются стандартные для РК движения (счета — по типовому плану счетов РК, ставка НДС 16%):
Пример: реализация товаров с выпиской ЭСФ (тенге)
| Дт | Кт | Содержание |
|---|---|---|
| 1210 | 6010 | Отражена задолженность покупателя и доход от реализации (без НДС) |
| 1210 | 3130 | НДС по реализации, 16% (к уплате) |
| 7010 | 1330 | Списана себестоимость реализованных товаров |
Пример: поступление/оплата (тенге)
| Дт | Кт | Содержание |
|---|---|---|
| 1330 | 3310 | Оприходование товара, задолженность поставщику |
| 3310 | 1030 | Оплата поставщику с текущего счёта |
Виртуальный склад контрагента при этом выступает аналитикой/реквизитом электронного документа (СНТ/ЭСФ) и попадает в XML-выгрузку в ИС ЭСФ по своему ИдентификаторСклада; на состав проводок он не влияет.
6. Связанные объекты и ввод на основании
- Справочник.Контрагенты — владелец виртуального склада (реквизит
Контрагент). - Документы ЭСФ и СНТ — потребители справочника: склад контрагента указывается при выписке электронных документов и передаётся во внешние системы по
ИдентификаторСклада. - Помощник получения данных («Обновить виртуальные склады») — источник автоматического наполнения справочника через API контрагента.
- Перечисление статусов — источник значений реквизита
Статус.
Ввод на основании. Как источник ввода на основании справочник, как правило, не используется. Наполнение выполняется вручную (ФормаЭлемента) или автоматически через помощник получения данных/API-обмен.
7. Точки расширения
- Расширение конфигурации: добавление реквизитов (например, код региона, тип склада, срок действия), добавление собственных команд в ФормуСписка/ФормаВыбора, переопределение
ОбработкаПроверкиЗаполненияиПередЗаписьючерез расширяющие обработчики. - Подписки на события:
ПередЗаписью/ПриЗаписисправочника — для журналирования изменений или каскадной синхронизации с внешней системой. - Интеграция: доработка помощника получения данных под конкретный API контрагента; сопоставление внешних
idпри загрузке; дедупликация по паре «Контрагент + ИдентификаторСклада». - Отборы форм выбора: программное добавление отборов (по региону, признаку основного склада) для подбора в документах ЭСФ/СНТ.
- Дополнительные реквизиты и сведения (механизм БСП) — если требуется расширять карточку без изменения конфигурации.