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