Часть 4. Как устроена конвертация данных в модуле

Время на изучение: 40 минут.

Цель: понять механику работы модуля до того, как переходить к настройке сценариев. Вы узнаете, что такое НКД и НКС, какие есть типы настройки конвертации документов и в каких случаях модуль работает «из коробки», а в каких нужна ручная настройка.

Содержание:

4.1. Как модуль формирует ЭПД из данных 1С
4.2. Три механизма настройки
4.3. НКД — как работает конвертация документов
4.4. НКС — конвертация справочников
4.5. НКР — конвертация регистров сведений

4.1. Как модуль формирует ЭПД из данных 1С

Настройка модуля — это установка соответствий между полями документов 1С и полями электронных перевозочных документов (ЭПД). Модуль не меняет данные вашей учетной системы — он создает свои объекты, например , на основе данных 1С по заданным вами правилам.

Почему модуль хранит свои объекты отдельно. Учётная система 1С — это учет хозяйственной деятельности вашей компании. Модуль работает с ним бережно: читает нужные данные, но не записывает изменения обратно в 1С, чтобы не нарушить учёт. Из документа 1С в объект Логистики попадает только та часть данных, которая нужна для формирования ЭПД по формату ФНС.

Пример: сотрудник компании «Солнечные продукты» создает ЭТрН на основе документа учетной системы «Реализация товаров». Модуль использует данные из этого документа: организацию, контрагента, склад и товары. На основе этих данных создается объект ЭТрН, а сам документ «Реализация товаров» не меняется.

4.2. Три механизма настройки

Модуль Логистики использует три механизма конвертации. Эти сокращения будут встречаться дальше. Ниже — краткое описание каждого механизма.

Механизм	Что настраивает	Когда используется
НКД (настройки конвертации документов)	Как документ 1С преобразуется в ЭПД и обратно.	Основной механизм, используется всегда.
НКС (настройки конвертации справочников)	Как элемент справочника 1С преобразуется в элемент справочника модуля.	Когда в ЭПД нужно передать структуру: водитель, ТС, контрагент.
НКР (настройки конвертации регистров сведений)	Как записи регистра преобразуется в данные ЭПД.	Только для ЭПЛ, если нужно передать данные по .

Для первичной настройки вам достаточно НКД и НКС. Регистры сведений понадобятся только если вы работаете с путевыми листами.

4.3. НКД — как работает конвертация документов

НКД — это справочник в модуле. Каждый элемент справочника задает одно правило: «документ такой-то в 1С превращается в титул такой-то ЭПД».

НКД работает в обе стороны:

Прямой маппинг: из документа 1С в ЭПД. Когда вы формируете или .

Обратный маппинг: из ЭПД в документ 1С. Когда приходит подтверждённый документ от контрагента и данные нужно отразить в основном учете.

В нашем примере «Солнечным продуктам» нужны четыре НКД:

Реализация товаров → . Компания формирует заявку на перевозку.
Реализация товаров → . Компания формирует транспортную накладную.
Входящая → данные о транспортном средстве и водителе попадают в 1С. Обратный маппинг.
Входящая → отметка о получении возвращается в 1С. Обратный маппинг.

Для типовых конфигураций и типовых документов базовая конвертация прописана в коде модуля. Вам не нужно создавать их с нуля — они работают «из коробки».

Создавать настройку вручную нужно в следующих случаях:

у вас нетиповой документ-основание;
нужно переопределить отдельные поля;
сценарий сложнее базового: с участием , экспедитора или при самовывозе.

Примитивные поля и поля-структуры

Поля ЭПД бывают двух типов, и они настраиваются по-разному.

Простые поля — строка, число, дата. Например, номер ЭТрН или дата отправки. Здесь достаточно указать напрямую реквизит документа 1С: «Номер ЭТрН = Основание.Номер».

Для работы с ЭПД отправителям грузов, перевозчикам и экспедиторам понадобится пакет документов

Смотреть тарифы

Поля-структуры — это составные поля. Например, «Водитель» в ЭТрН по формату ФНС — это не просто ФИО, а структура: фамилия, имя, отчество, ИНН, серия и номер водительского удостоверения (ВУ), дата выдачи. В 1С водитель обычно хранится как ссылка на элемент справочника «Сотрудники» — один реквизит, а в ЭПД нужна развернутая структура из шести полей. Для таких случаев используется .

Три типа НКД

У каждой НКД есть реквизит «Тип», который определяет, как модуль ее использует.

Тип	Когда использовать	Что можно настроить
Основная	Типовой документ, типовая конфигурация, простой сценарий.	Сценарий, валидации отправки, дополнительные колонки списка задач.
Расширенная	Типовой документ, но нужно переопределить отдельные поля или добавить логику.	Все, что в основной, а также переопределение реквизитов, объединение или разделение документов, условия списка задач.
Замещающая	Нетиповой документ, серьёзные доработки или сложные сценарии.	Все. Полная свобода настройки — типовая настройка не используется.

Как выбрать тип

1 вариант. Типовая конфигурация + типовой документ + базовый сценарий (1/9/10) → ничего не создавать, работают встроенные настройки.

2 вариант. Типовой документ, но сценарий самовывоза, или экспедиция → расширенная

3 вариант. Нетиповой документ или сложная логика → замещающая

Пример: компания «Солнечные продукты» на конфигурации УТ 11 использует типовой документ «Реализация товаров» и простой сценарий 1. Поэтому создавать НКД не нужно — встроенные настройки сформируют ЭЗЗ и ЭТрН автоматически. Если бы у них был самовывоз (сценарий 2), потребовалась бы расширенная НКД для переопределения поля «ПогрузкуОсуществляет».

Структура ЭТрН: главный документ и титулы

Прежде чем переходить к настройке, важно понять внутреннее устройство . Это сильно упростит работу с НКД в Части 5. Накладная состоит из двух уровней: главный документ и титулы.

Главный документ ЭТрН — общие данные перевозки, которые не меняются на разных этапах:

Участники: грузоотправитель, грузополучатель, перевозчик
Маршрут: место погрузки, место доставки
Транспорт: , прицеп
Признаки: это экспедиция, номер, дата

Главный документ один на всю перевозку. Его данные видят все участники — и , и , и .

Титулы — подписываемые части документа. Каждый титул содержит специфические поля, относящиеся к действию конкретного участника:

Т1 (ГО): дата подачи ТС, водитель, груз, переадресация — то, что фиксирует отправитель при погрузке;

Т2 (ПРВ): подтверждение приёмки, данные при погрузке;

Т3 (ГП): приёмка, возможные замечания;

Т4 (ПРВ): сдача груза, данные при разгрузке.

Как это связано с НКД

В НКД для ЭТрН Т1 есть несколько вкладок:

Вкладка	За что отвечает
ЭТрН — главный документ	Заполняет общие поля ЭТрН (грузоотправитель, перевозчик, маршрут)
Титул (документ)	Заполняет специфические поля Т1 (дата подачи, метод определения массы, инициатор переадресации)
Таб. часть Товары	Заполняет список товаров в титуле
Колонки списка	Определяет, как документ отображается в списке задач модуля

Одна НКД настраивает один титул плюс все данные главного документа, которые нужны для этого титула. Когда вы будете настраивать НКД для Т1 ЭТрН, вы заполните и главный документ, и поля Т1 — в рамках одной НКД, но на разных вкладках.

Для каждого титула, который формирует ваша организация, создается отдельная НКД. Если вы ГО — вам нужна НКД только для Т1. Если вы перевозчик и формируете Т2, Т4 — вам понадобятся две отдельные НКД. ГО не настраивает НКД для Т2, Т3, Т4, потому что это входящие титулы, которые подписывают другие участники.

Если готовой логики в НКД не хватает, можно использовать подключаемый модуль. Это механизм для сложных случаев, когда стандартных настроек недостаточно. Обычно не требуется для базовых сценариев.

Подробная инструкция: настройка конвертации документов

4.4. НКС — конвертация справочников

НКС — отдельный справочник в модуле. Каждый элемент описывает правило: «справочник 1С такой-то превращается в справочник модуля такой-то».

В нашем примере компании «Солнечные продукты» понадобятся три НКС:

Справочник «Сотрудники» 1С → «Сотрудники» модуля (водитель Иванов И. И. с и ИНН).
Справочник «Номенклатура» 1С → «Номенклатура» модуля (молоко с упаковкой, весом).
Справочник «Контрагенты» 1С → «Контрагенты» модуля («Магазин Ромашка» с ИНН, КПП, адресом).

Как и с НКД — для типовых справочников базовые НКС уже созданы. Настройка НКС нужна только если в ваших справочниках есть нетиповые реквизиты. Например, ВУ водителя хранится в отдельной табличной части.

Подробная инструкция: настройка конвертации справочников

4.5. НКР — конвертация регистров сведений

НКР нужны только для для передачи показаний ГСМ при работе с электронным путевым листом (ЭПЛ). Если вы настраиваете только ЭТрН и ЭЗЗ, пропускайте этот пункт.

Подробная инструкция: внесение показаний ГСМ

Механизм настроек конвертации (НКД) используется и для экспедиторских документов: поручение экспедитору можно формировать на основании документов 1С «Реализация товаров и услуг» и «Перемещение товаров». Для конфигураций БП 3.0, УТ 11.4/11.5, КА 2.5 и ERP 2.5 действует типовая конвертация. Подробнее — в разделе 8.2.

Оцените понятность инструкции. Если на каком-то этапе потребовалась помощь, напишите об этом в анкете.

Перейти к следующей части