1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Документ (Документ.РассылкаКлиентам) |
| Имя | РассылкаКлиентам |
| Синоним | «Рассылка клиентам» |
| Конфигурация | Управление торговлей для Казахстана, 3.4.5.21 |
| Раздел интерфейса | CRM и маркетинг (в дереве метаданных — рядом со служебными подсистемами взаимодействий) |
| Пользователь | Маркетолог |
| Нумерация | Тип Строка, длина 9, непериодическая (Nonperiodical) |
| Навигационная ссылка (список) | e1cib/list/Документ.РассылкаКлиентам |
| Навигационная ссылка (объект) | e1cib/data/Документ.РассылкаКлиентам |
Назначение. Документ оформляет массовую рассылку (email и/или SMS) клиентам в рамках маркетинговых активностей: фиксирует, по какому сегменту (отбору адресатов), с каким текстом и в каком канале выполняется коммуникация, а затем хранит результаты для последующего анализа. Это инструмент CRM/маркетинга, а не финансово-учётный документ.
Важно для разработчика: несмотря на то, что конфигурация ведёт учёт по РК (ставка НДС 16 %, план счетов 1210/1030/1330/3310/3130/6010/7010, ЭСФ/СНТ), данный документ к денежному, товарному и налоговому учёту отношения не имеет и никаких сумм/ставок не рассчитывает. Налоговые и складские нормы РК к этому объекту неприменимы.
2. Реквизиты шапки и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обяз. | Назначение |
|---|---|---|---|
ДатаРассылки |
Дата | Да | Дата планируемой/фактической рассылки. |
ДатаАктуальности |
Дата | Нет | Дата, до которой рассылка считается актуальной. |
Основание |
СправочникСсылка.МаркетинговыеМероприятия / ДокументСсылка.НазначениеОпросов | Нет | Основание рассылки — маркетинговое мероприятие или назначение опросов. |
ГруппаРассылокИОповещений |
СправочникСсылка.ГруппыРассылокИОповещений | Да | Группа, к которой относится рассылка (настройки канала/отправителя). |
ПредназначенаДляЭлектронныхПисем |
Булево | Нет | Признак канала «email». |
ПредназначенаДляSMS |
Булево | Нет | Признак канала «SMS». |
Тема |
Строка | Да | Тема письма. |
ТекстПисьма |
Строка | Да | Текст письма (обычный). |
ТекстПисьмаHTML |
Строка | Нет | Текст письма в формате HTML. |
ТекстSMS |
Строка | Да | Текст SMS-сообщения. |
ОтборАдресатов |
ХранилищеЗначения | Нет | Сериализованные настройки компоновщика отбора получателей. |
ТипТекстаПисьма |
ПеречислениеСсылка.СпособыРедактированияЭлектронныхПисем | Да | Способ формирования текста (обычный/HTML). |
Статус |
ПеречислениеСсылка.СтатусыРассылокКлиентам | Да | Статус в жизненном цикле (черновик/подготовлена/отправлена и т. п.). |
ОтправлятьВТранслите |
Булево | Нет | Транслитерация текста при отправке (для SMS). |
Комментарий |
Строка | Нет | Произвольный комментарий. |
ПредставлениеОтбора |
Строка | Нет | Человекочитаемое представление отбора адресатов. |
Ответственный |
СправочникСсылка.Пользователи | Нет | Ответственный за документ. |
ЕстьВложения |
Булево | Нет | Признак наличия присоединённых файлов. |
2.2 Табличная часть ДополнительныеПолучатели
Дополнительные адресаты сверх тех, что попали в рассылку по отбору сегмента.
| Имя | Тип | Назначение |
|---|---|---|
Контакт |
СправочникСсылка.Партнеры / СправочникСсылка.КонтактныеЛицаПартнеров | Дополнительный получатель — партнёр или контактное лицо. |
КонтактнаяИнформация |
Строка | Явный адрес/номер (email или телефон), если задаётся вручную. |
3. Формы
| Форма | Роль | Состав (по evidence) |
|---|---|---|
ФормаДокумента |
Основная форма документа. | 295 элементов, 14 полей ввода, 3 таблицы, 16 кнопок. Вкладки: СтраницаСообщение, СтраницаСообщениеSMS, СтраницаЭлектронноеПисьмо, СтраницаТекстПисьмаОбычный, СтраницаТекстПисьмаHTML, СтраницаАдресаты, СтраницаКомментарий. Таблицы: Вложения, КомпоновщикНастроекНастройкиОтбор, ДополнительныеПолучатели. |
ВзаимодействияПоРассылке |
Список взаимодействий (писем/сообщений), порождённых рассылкой, — для контроля отправки и переписки. | 51 элемент, 2 поля ввода, 1 таблица (Список), 1 кнопка. |
СостояниеРассылки |
Индикатор прогресса/итогов отправки. | 10 элементов, кнопка Обновить. |
Форма списка отдельно в метаданных не выделена — открывается по стандартной ссылке e1cib/list/Документ.РассылкаКлиентам.
4. Ключевые процедуры модулей
Данные ниже получены статическим анализом BSL-модулей (parse_bsl + build_bsl_digest, без выполнения кода). Имена обработчиков — дословно из выгрузки.
Модуль объекта (ObjectModule):
| Обработчик | Объём | Назначение |
|---|---|---|
ОбработкаПроверкиЗаполнения |
123 стр. | Наиболее объёмный обработчик. Валидация перед записью: проверка непротиворечивости выбранных каналов (ПредназначенаДляЭлектронныхПисем/ПредназначенаДляSMS) и соответствующих текстов (Тема/ТекстПисьма/ТекстПисьмаHTML/ТекстSMS), наличия отбора адресатов либо строк ДополнительныеПолучатели, корректности ТипТекстаПисьма. Удаляет из автоматической проверки неактуальные для выбранного канала реквизиты. |
ПередЗаписью |
20 стр. | Донастройка перед записью: синхронизация ЕстьВложения и ПредставлениеОтбора, подстановка Ответственный, нормализация связки «канал ↔ тип текста». |
ОбработкаЗаполнения |
20 стр. | Инициализация нового документа, в т. ч. при вводе на основании (Основание → маркетинговое мероприятие/назначение опросов): заполнение ДатаРассылки, Статус, ГруппаРассылокИОповещений, ответственного. |
ПриКопировании |
3 стр. | Сброс результирующих/статусных реквизитов при копировании (например, приведение Статус к исходному значению), чтобы копия не наследовала факт отправки. |
Зависимости от общих модулей (число вызовов): ОбщегоНазначенияКлиентСервер (9), СтроковыеФункцииКлиентСервер (6), ОбщегоНазначения (2), Пользователи (1), ОбщегоНазначенияУТ (1). Использование СтроковыеФункцииКлиентСервер характерно для сборки текста сообщений и подстановки параметров в шаблон; Пользователи — для определения текущего пользователя/ответственного.
В выгрузке присутствуют только перечисленные обработчики модуля объекта. Модули форм и менеджера в digest не детализированы — фактическую логику отправки следует смотреть в модулях форм
ФормаДокумента/СостояниеРассылкии в подсистеме рассылок конкретной версии (требует проверки для 3.4.5.21).
5. Проведение и движения
Документ не является проводимым в учётном смысле. По результатам анализа состав движений пуст (RegisterRecords не определён), обработчики ОбработкаПроведения/ОбработкаУдаленияПроведения в модуле объекта отсутствуют.
Следствия для разработчика:
- документ не формирует бухгалтерских проводок (счета 1210, 1030, 1330, 3310, 3130, 6010, 7010 и др. здесь не задействованы);
- документ не делает движений по регистрам товаров, расчётов, денежных средств, цен и НДС;
- документ не порождает электронных документов учёта (ЭСФ, СНТ);
- жизненный цикл отражается не проведением, а реквизитом
Статус(ПеречислениеСсылка.СтатусыРассылокКлиентам) и результатами в связанных взаимодействиях.
Фактический «эффект» документа — отправка сообщений и регистрация взаимодействий: по подготовленному отбору формируется аудитория, создаются объекты «Взаимодействия» (письма/SMS), а их состояние агрегируется формой СостояниеРассылки и списком ВзаимодействияПоРассылке.
6. Связанные объекты и ввод на основании
Ввод на основании (источники, реквизит Основание):
Справочник.МаркетинговыеМероприятия;Документ.НазначениеОпросов.
Используемые справочники/перечисления:
Справочник.ГруппыРассылокИОповещений— настройки группы рассылки;Справочник.Партнеры,Справочник.КонтактныеЛицаПартнеров— адресаты;Справочник.Пользователи— ответственный;Перечисление.СпособыРедактированияЭлектронныхПисем—ТипТекстаПисьма;Перечисление.СтатусыРассылокКлиентам—Статус.
Порождаемые/связанные объекты:
- объекты подсистемы «Взаимодействия» (email/SMS), отображаемые формой
ВзаимодействияПоРассылке; - присоединённые файлы (
Вложения, признакЕстьВложения).
7. Точки расширения
- Обработчики модуля объекта —
ПередЗаписью,ОбработкаЗаполнения,ОбработкаПроверкиЗаполнения,ПриКопировании: расширяются через модуль расширения/подписки на события для донастройки правил заполнения и валидации каналов. - Подписки на события (
ПередЗаписью/ПриЗаписи) — для интеграции с внешними сервисами рассылок и логирования. - Формы
ФормаДокумента,ВзаимодействияПоРассылке,СостояниеРассылки— расширение форм (добавление реквизитов, команд, дополнительной аналитики отправки). - Компоновщик отбора адресатов (
ОтборАдресатов/КомпоновщикНастроекНастройкиОтбор) — точка для кастомных условий формирования аудитории. - Дополнительные реквизиты/сведения — через механизм свойств для классификации рассылок.
- Общие модули
ОбщегоНазначенияУТ,ОбщегоНазначенияКлиентСервер— обёртки для переопределяемой бизнес-логики.