Документ «Транспортное сообщение»
«Транспортное сообщение» — служебный (технический) документ подсистемы электронного документооборота с налоговыми органами. Он представляет собой транспортный «конверт» одного сообщения обмена: фиксирует тип сообщения (ЕnumRef.ТипыТранспортныхСообщений), отправителя и получателя (налоговый орган или сервер документооборота), учётную запись документооборота, статус письма, тему, текст письма, технические почтовые атрибуты (адресаты «Кому/Копии/Скрытые копии», кодировка, важность) и сертификаты получателей для шифрования. Документ не формирует движений по регистрам (register_records пуст) и не имеет собственных форм и команд (forms и commands пусты) — то есть он не рассчитан на ручной ввод пользователем, а создаётся и обрабатывается программно механизмом обмена; пользователь обращается к нему в основном для диагностики и трассировки переписки с налоговым органом. Место в меню/интерфейсе: (не определено — в карте объекта нет сведений). Нумерация: тип номера String, длина номера 0 (номер фактически не используется), периодичность — Nonperiodical.
Конфигурация: «Зарплата и управление персоналом для Казахстана», ред. 3.1. Пометка о происхождении: объект — наследие типовой (российской) подсистемы электронного документооборота с контролирующими органами, адаптированной под обмен с налоговыми органами РК. В составных типах реквизитов сохранились устаревшие RU-справочники с префиксом «Удалить…» (УдалитьНалоговыеОрганы, УдалитьСерверыДокументооборота, УдалитьУчетныеЗаписиДокументооборота) — признак миграции из типовой.
1. Назначение и место в учёте
«Транспортное сообщение» — служебный (технический) документ подсистемы электронного документооборота с налоговыми органами. Он представляет собой транспортный «конверт» одного сообщения обмена: фиксирует тип сообщения (ЕnumRef.ТипыТранспортныхСообщений), отправителя и получателя (налоговый орган или сервер документооборота), учётную запись документооборота, статус письма, тему, текст письма, технические почтовые атрибуты (адресаты «Кому/Копии/Скрытые копии», кодировка, важность) и сертификаты получателей для шифрования. Документ не формирует движений по регистрам (register_records пуст) и не имеет собственных форм и команд (forms и commands пусты) — то есть он не рассчитан на ручной ввод пользователем, а создаётся и обрабатывается программно механизмом обмена; пользователь обращается к нему в основном для диагностики и трассировки переписки с налоговым органом. Место в меню/интерфейсе: (не определено — в карте объекта нет сведений). Нумерация: тип номера String, длина номера 0 (номер фактически не используется), периодичность — Nonperiodical.
2. Структура объекта
2.1 Реквизиты шапки
У всех реквизитов fill_value_required = DontCheck — платформенная проверка заполнения не выполняется ни для одного поля.
| Имя | Тип | Обязательность | Зачем нужен |
|---|---|---|---|
| ЦиклОбмена | CatalogRef.ЦиклыОбмена | не проверяется (DontCheck) | Привязка сообщения к циклу обмена с налоговым органом; группирует сообщения одной сессии/цепочки обмена. |
| Тип | EnumRef.ТипыТранспортныхСообщений | не проверяется | Вид транспортного сообщения; определяет роль сообщения в протоколе обмена. |
| Отправитель | CatalogRef.УдалитьНалоговыеОрганы, CatalogRef.УдалитьСерверыДокументооборота, CatalogRef.НалоговыеОрганы (составной) | не проверяется | Кто отправил сообщение. Актуальный тип — НалоговыеОрганы; типы с префиксом «Удалить…» — устаревшее наследие типовой RU-конфигурации. |
| Получатель | CatalogRef.УдалитьНалоговыеОрганы, CatalogRef.УдалитьСерверыДокументооборота, CatalogRef.НалоговыеОрганы (составной) | не проверяется | Кому адресовано сообщение; состав типов тот же, что у Отправителя. |
| УчетнаяЗапись | CatalogRef.УдалитьУчетныеЗаписиДокументооборота, CatalogRef.УчетныеЗаписиДокументооборота (составной) | не проверяется | Учётная запись документооборота, через которую идёт обмен. Актуальный тип — УчетныеЗаписиДокументооборота; «Удалить…» — устаревший. |
| Статус | EnumRef.СтатусыПисем | не проверяется | Текущий статус письма в цикле обработки (статусная модель почтового сообщения). |
| Тема | Строка (xs:string) | не проверяется | Тема письма транспортного сообщения. |
| ТекстПисьма | Строка (xs:string) | не проверяется | Текст (тело) письма. |
| ИдентификаторСообщения | Строка (xs:string) | не проверяется | Уникальный идентификатор сообщения в транспортной системе; ключ для трассировки. |
| ДатаТранспорта | ДатаВремя (xs:dateTime) | не проверяется | Дата/время транспортировки (передачи) сообщения. |
| Важность | Число (xs:decimal) | не проверяется | Числовой признак важности письма (почтовый атрибут). |
| Кодировка | Строка (xs:string) | не проверяется | Кодировка письма. |
| ОтКогоАдрес | Строка (xs:string) | не проверяется | Электронный адрес отправителя («От кого (адрес)»). |
| ОтКогоПредставление | Строка (xs:string) | не проверяется | Отображаемое имя отправителя («От кого (представление)»). |
| Основание | DocumentRef.ТранспортноеСообщение | не проверяется | Ссылка на другое транспортное сообщение — строит цепочку «запрос → ответ» внутри обмена (самоссылка на этот же вид документа). |
| ПротоколСОшибкой | Булево (xs:boolean) | не проверяется | Маркер того, что по сообщению получен протокол с ошибкой. |
| НеОбрабатывать | Булево (xs:boolean) | не проверяется | Флаг исключения сообщения из автоматической обработки механизмом обмена. |
2.2 Табличные части
ДополнительныеРеквизитыЗаголовка («Дополнительные реквизиты заголовка») — произвольные дополнительные атрибуты заголовка сообщения в виде пар «тип — значение».
| Имя | Тип | Назначение |
|---|---|---|
| Тип | Строка (xs:string), EnumRef.ТипыДополнительныхРеквизитов (составной) | Тип дополнительного реквизита заголовка. |
| Значение | Строка (xs:string) | Значение дополнительного реквизита. |
Кому («Кому») — основные адресаты письма.
| Имя | Тип | Назначение |
|---|---|---|
| АдресЭлектроннойПочты | Строка (xs:string) | E-mail адресата. |
| Представление | Строка (xs:string) | Отображаемое имя адресата. |
Копии («Копии») — адресаты копии письма.
| Имя | Тип | Назначение |
|---|---|---|
| АдресЭлектроннойПочты | Строка (xs:string) | E-mail адресата копии. |
| Представление | Строка (xs:string) | Отображаемое имя адресата копии. |
СкрытыеКопии («Скрытые копии») — адресаты скрытой копии.
| Имя | Тип | Назначение |
|---|---|---|
| АдресЭлектроннойПочты | Строка (xs:string) | E-mail адресата скрытой копии. |
| Представление | Строка (xs:string) | Отображаемое имя адресата скрытой копии. |
СертификатыПолучателей («Сертификаты получателей») — сертификаты шифрования/подписи получателей сообщения.
| Имя | Тип | Назначение |
|---|---|---|
| СерийныйНомер | Строка (xs:string) | Серийный номер сертификата. |
| ПоставщикCN | Строка (xs:string) | CN (Common Name) поставщика/издателя сертификата. |
| Отпечаток | Строка (xs:string) | Отпечаток сертификата. |
| Сторонний | Булево (xs:boolean) | Признак стороннего сертификата. |
2.3 Формы
В карте объекта собственных форм нет (forms: []). Ключевая форма для пользователя: (не определено) — при интерактивном открытии платформа использует автогенерируемую форму. Команд объекта также нет (commands: []).
3. Сценарии работы
Объект служебный: собственных форм, команд и кода модулей в карте нет, поэтому сценарии ручного «создания с нуля» нетипичны — документ порождается механизмом обмена. Ниже сценарии, реалистичные для пользователя/агента.
3.1 Сценарий: «Просмотр транспортного сообщения (Read)»
- Когда применяется: нужно посмотреть содержимое отправленного/полученного сообщения обмена с налоговым органом.
- Шаги пользователя: 1. Открыть список документов «Транспортное сообщение» (через «Все функции»/служебный интерфейс — собственное место в меню не определено). 2. Найти нужное сообщение по дате (ДатаТранспорта), теме (Тема) или идентификатору (ИдентификаторСообщения). 3. Открыть документ (автогенерируемая форма) и просмотреть Отправителя, Получателя, Статус, ТекстПисьма и табличные части.
- На что обратить внимание: Статус (EnumRef.СтатусыПисем) показывает стадию обработки; ПротоколСОшибкой — был ли по сообщению протокол с ошибкой.
- Какие проверки сработают: никаких — все реквизиты DontCheck, проверка заполнения не настроена.
- После «Записать»: документ просто записывается; движений по регистрам нет.
3.2 Сценарий: «Диагностика ошибки обмена»
- Когда применяется: обмен с налоговым органом завершился ошибкой, нужно найти проблемное сообщение.
- Шаги пользователя: 1. В списке транспортных сообщений отобрать документы с ПротоколСОшибкой = Истина. 2. Открыть сообщение, изучить Тема/ТекстПисьма и ИдентификаторСообщения. 3. По реквизиту Основание перейти к исходному сообщению цепочки (запросу), к которому пришёл ошибочный ответ. 4. Проверить УчетнаяЗапись и ЦиклОбмена, в рамках которых шёл обмен.
- Поля: ПротоколСОшибкой, Основание, ИдентификаторСообщения, Статус.
- Проверки: платформенных проверок нет.
- После «Записать»: только запись; обработку ошибки выполняет подсистема обмена, не сам документ.
3.3 Сценарий: «Исключение сообщения из обработки (Update)»
- Когда применяется: «зависшее» или дублирующее сообщение нужно вывести из автоматической обработки механизмом обмена.
- Шаги пользователя: 1. Открыть проблемное транспортное сообщение. 2. Установить флаг НеОбрабатывать = Истина. 3. Записать документ.
- На что обратить внимание: флаг — единственный штатный рычаг ручного вмешательства в обработку, видимый из структуры объекта; снятие флага возвращает сообщение в обработку.
- Проверки: не настроены (DontCheck).
- После «Записать»: документ записан; движений нет, реакция механизма обмена на флаг определяется кодом подсистемы (в карте объекта не представлен).
3.4 Сценарий: «Трассировка цепочки обмена»
- Когда применяется: нужно восстановить последовательность «запрос → ответ → протокол» по одному циклу обмена.
- Шаги пользователя: 1. Открыть любое сообщение цепочки и посмотреть ЦиклОбмена. 2. Отобрать в списке все сообщения этого ЦиклаОбмена. 3. Упорядочить по ДатаТранспорта; связи «кто на основании кого» смотреть по реквизиту Основание (ссылка на родительское ТранспортноеСообщение). 4. Сопоставить Тип каждого сообщения (EnumRef.ТипыТранспортныхСообщений) с его ролью в протоколе.
- Поля: ЦиклОбмена, Основание, ДатаТранспорта, Тип, ИдентификаторСообщения.
- Проверки: нет.
- После «Записать»: не требуется — сценарий только на чтение.
3.5 Сценарий: «Контроль адресатов и сертификатов шифрования»
- Когда применяется: нужно проверить, кому фактически ушло сообщение и какими сертификатами шифровалось.
- Шаги пользователя: 1. Открыть документ. 2. Просмотреть ТЧ «Кому», «Копии», «СкрытыеКопии» (адрес + представление каждого адресата). 3. Просмотреть ТЧ «СертификатыПолучателей»: СерийныйНомер, ПоставщикCN, Отпечаток, признак Сторонний. 4. При необходимости сверить ОтКогоАдрес/ОтКогоПредставление с настройками учётной записи (УчетнаяЗапись).
- Проверки: нет.
- После «Записать»: только запись, движений нет.
4. Per-field reference
Обработчиков ПриИзменении в карте нет (bsl_static пуст), модуль ОбработкаПроверкиЗаполнения не представлен — поэтому для всех полей: влияние на другие поля и валидация = (не определено). Приоритетные поля:
- Тип (EnumRef.ТипыТранспортныхСообщений): вид транспортного сообщения, определяет его роль в протоколе обмена; обязательность не проверяется; типичные значения — элементы перечисления ТипыТранспортныхСообщений (состав в карте не приведён).
- Статус (EnumRef.СтатусыПисем): стадия жизненного цикла письма; не проверяется; меняется механизмом обмена; типичные значения — элементы перечисления СтатусыПисем (состав в карте не приведён).
- УчетнаяЗапись (составной: CatalogRef.УчетныеЗаписиДокументооборота + устаревший CatalogRef.УдалитьУчетныеЗаписиДокументооборота): учётная запись, через которую выполняется обмен; для актуальных данных использовать УчетныеЗаписиДокументооборота.
- Отправитель / Получатель (составной: CatalogRef.НалоговыеОрганы + устаревшие CatalogRef.УдалитьНалоговыеОрганы, CatalogRef.УдалитьСерверыДокументооборота): стороны обмена; актуальный тип — НалоговыеОрганы.
- ЦиклОбмена (CatalogRef.ЦиклыОбмена): группирует сообщения одного цикла обмена; ключ отбора при трассировке.
- ИдентификаторСообщения (Строка): уникальный идентификатор в транспортной системе; основной ключ сопоставления с внешней системой (номер документа не используется — длина номера 0).
- ДатаТранспорта (ДатаВремя): момент передачи сообщения; основное поле сортировки истории обмена.
- Основание (DocumentRef.ТранспортноеСообщение): родительское сообщение цепочки; самоссылка, связывает запрос и ответ.
- ПротоколСОшибкой (Булево): Истина — по сообщению получен протокол с ошибкой; ключевое поле диагностики.
- НеОбрабатывать (Булево): Истина — сообщение исключено из автоматической обработки; единственный «ручной» управляющий флаг.
- Тема / ТекстПисьма / Кодировка / Важность / ОтКогоАдрес / ОтКогоПредставление (Строка/Число): почтовые атрибуты содержимого письма; заполняются механизмом обмена; проверок нет.
5. Бизнес-логика
- Обработчики событий: (не определено) — bsl_static и bsl_summaries в карте пусты, код модулей объекта не представлен.
- Проводки: отсутствуют — ОбработкаПроведения в карте не представлена, register_records пуст; документ не делает движений ни по каким регистрам.
- Валидации: (не определено) — ОбработкаПроверкиЗаполнения не представлена; на уровне метаданных все реквизиты DontCheck.
- Зависимости от других модулей: по структуре объект зависит от справочников ЦиклыОбмена, НалоговыеОрганы, УчетныеЗаписиДокументооборота (и их устаревших RU-двойников УдалитьНалоговыеОрганы, УдалитьСерверыДокументооборота, УдалитьУчетныеЗаписиДокументооборота), перечислений ТипыТранспортныхСообщений, СтатусыПисем, ТипыДополнительныхРеквизитов. Логика обмена живёт вне объекта (в общих модулях подсистемы документооборота; в карте не представлены).
6. Связи с другими объектами
6.1 Документы-основания
based_on пуст — документ не вводится «на основании» других видов документов. Внутренняя связь — реквизит Основание (DocumentRef.ТранспортноеСообщение): ссылка на родительское транспортное сообщение той же цепочки.
6.2 Кто создаётся на основании этого
inverse_based_on пуст — (не определено) других документов, вводимых на основании Транспортного сообщения, в карте нет.
6.3 Регистры движения
register_records пуст — документ никуда не пишет движений.
7. Заметки для ИИ-агента
- Не создавай этот документ вручную — у объекта нет собственных форм и команд; он порождается механизмом обмена с налоговыми органами. Ручное вмешательство ограничь чтением и флагом НеОбрабатывать.
- Открытие в UI — только автогенерируемая форма платформы; не ищи специализированные элементы формы по именам — DOM-селекторы строй от имён реквизитов из раздела 2.1 (они в метаданных дословно).
- Никакие поля не обязательны (все DontCheck): пустой документ запишется без ошибок — отсутствие платформенных проверок не означает корректность; целостность данных обеспечивает подсистема обмена.
- Составные типы с «Удалить…» (УдалитьНалоговыеОрганы, УдалитьСерверыДокументооборота, УдалитьУчетныеЗаписиДокументооборота) — устаревшее наследие типовой RU-конфигурации: при чтении старых данных они могут встречаться, при записи используй актуальные НалоговыеОрганы / УчетныеЗаписиДокументооборота.
- Идентификация сообщения — не по номеру: длина номера 0, номер не используется; ключи — ИдентификаторСообщения, ДатаТранспорта, ЦиклОбмена.
- Диагностика: ПротоколСОшибкой = Истина — маркер ошибки обмена; цепочку «запрос → ответ» восстанавливай по реквизиту Основание и отбору по ЦиклОбмена.
- Проведение не создаёт движений — не жди записей в регистрах после «Провести»; документ чисто транспортный.