1с розница изменить формат обмена

Обновлено: 04.07.2024

В статье описан порядок действий при подключении нетиповых документов к механизму «Синхронизация данных через универсальный формат» (КД 3.0).

В контексте данной статьи термин «нетиповой» означает, что документ не описан ни в одном из XDTO-пакетов механизма «Синхронизация данных через универсальный формат».

Если же документ описан в типовом XDTO-пакете, то порядок его подключения к обмену можно посмотреть в статье «Обмен через универсальный формат (КД 3.0): подключение типового документа».

1. Зачем изменять типовой XDTO-пакет?

Основной смысл технологии КД 3.0 (обмен через универсальный формат) – это добиться «универсальности» правил обмена, чтобы правила выгрузки/загрузки объектов не зависели от того, какая конфигурация (или ее релиз) находятся на том «конце провода». И если мы корректируем типовой XDTO-пакет, то мы эту «универсальность» разрушаем.

Но в полной мере преимуществом «универсальности» может воспользоваться только сама 1С (и ее партнеры – разработчики конфигураций), которая таким образом упрощает себе процедуры обновления правил обмена при переходе от одного релиза типовых конфигураций 1С 8.3 к другим, а также упрощает подключения к обменам новых конфигураций.

На стороне пользователя выгоды от «универсальности» гораздо меньше, ведь он работает с конкретной конфигурацией-источником и конкретной конфигурацией-приемником. Все изменения правил обмена между этими конфигурациями (в т.ч. структура XDTO-пакетов) согласованы внутри его «корпорации». А то, что его правила обмена становятся несовместимы с правилами обмена, принятыми в других «корпорациях», его в большинстве случаев не волнует. Поэтому изменить структуру XDTO-пакета обычно некритично.

Более того, если речь идет о добавлении в обмен новых объектов, то технически это проще сделать через технологию КД 2.0:

· Там нужно писать всего один комплект правил обмена вместо двух для КД 3.0.

· Включение в обмен КД 3.0 промежуточного «универсального формата» сильно повышает уровень абстракции (он уже не связан напрямую с прикладной областью) и избыточности (он же «универсальный»). А это, в свою очередь, повышает требования к квалификации специалистов, которые этот обмен будут настраивать.

Но в последних конфигурациях 1С продвигается обмен именно по технологии КД 3.0. И чтобы для своих нетиповых объектов не строить параллельно еще и второй механизм обмена (на КД 2.0), приходится корректировать типовые XDTO-пакеты.

Есть описания примеров, когда для нетиповых объектов создаются отдельные XDTO-пакеты, а для работы с ними в 1С запускается отдельная 1С 8.3 XDTO-фабрика. Но это опять-таки – построение параллельного механизма обмена (два механизма на КД 3.0), а этого хочется избежать.

Итак, если мы хотим остаться внутри единого механизма «Синхронизация данных через универсальный формат», и для нас некритичен факт изменения типового XDTO-пакета, то изменим типовой XDTO-пакет.

2. Образцы описания документа в XDTO-пакете

Объекты обмена, которые включены в состав механизма «Синхронизация данных через универсальный формат», описаны в XDTO-пакетах, наименования которых начинаются с «EnterpriseData». Например, EnterpriseData_1_2_3 … EnterpriseData_1_6_20, где 1_2, … 1_6 – это номера «версий форматов».

Добавлять описание своего объекта необязательно во все XDTO-пакеты EnterpriseData_1_2_3 … EnterpriseData_1_6_20. Достаточно это сделать только для того номера версии формата, на котором обмениваются наши конкретные конфигурации. Узнать его можно в настройках синхронизации данных.

Т.е. в нашем примере достаточно скорректировать пакет EnterpriseData_1_5_20.

Корректировать XDTO-пакет можно либо вручную, либо с использованием специализированного редактора.

Посмотрим на образец описания документа. В примере добавляем описание нетипового документа «экзРапортФ114». Вносим описание типа значения:

Вносим описание его структуры (реквизиты шапки, в т.ч. ключевые свойства, табличную часть «Сырье» и реквизиты строки табличной части:

Такую настройку необходимо выполнить в обеих обменивающихся конфигурациях. Поскольку одноименные XDTO-пакеты во всех конфигурациях одинаковы, то настройку достаточно произвести в одной из них, а во вторую – перенести настройки через «сравнение и объединение».

3. Обновление 1С 8.3 записей регистра сведений НастройкиОбменаДаннымиXDTO

После добавления описания документа в XDTO-пакет есть один тонкий момент. Даже если Вы включили свой документ (в примере - это «экзРапортФ114» синоним «Рапорт на выработку комбикорма») в состав плана обмена «СинхронизацияДанныхЧерезУниверсальныйФормат», и он появится на форме регистрации изменений, этот документ еще не включен в механизм обмена. Об этом свидетельствует его отсутствие на ветке «AvailableObjectTypes» файла обмена.

Дело в том, что механизм обмена содержит в себе описание «доступных объектов», которое среди прочего хранится в регистре сведений НастройкиОбменаДаннымиXDTO. «Доступные объекты» в этом регистре заполняются:

А) Из состава XDTO-пакет при первичной настройке плана обмена à определяются объекты, которые «в принципе могут обмениваться».

Б) При анализе правил обмена текущей конфигурации à уточняется перечень объектов, доступных на «прием» и «отправку» относительно текущей базы.

В) При анализе ветки AvailableObjectTypes полученного файла обмена от конфигурации-корреспондента à уточняется перечень объектов, доступных на «прием» и «отправку» относительно конфигурации-корреспондента.

Объект становится «доступным на отправку», если он «в принципе может обмениваться» (выполнен п.А), имеет правила «на отправку» в текущей базе (п.Б) и имеет правила «на приемку» в базе-корреспонденте (п.В). Аналогично «доступен на приемку», если есть п.А, есть правила «на приемку» у текущей (п.Б) и правила «на отправку» у корреспондента (п.В).

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

А вот с п.А сложнее. Как уже сказано, он выполняется при первичной настройке плана обмена 1С 8.3. Когда Вы добавляете свой объект, как правило, первичная настройка обмена уже произведена. Как быть?

Можно, например, в настройку синхронизации добавить команду «Обновить настройку синхронизации», которая перечитывает состав XDTO-пакетов. Текст модуля этой команды приведен в прил.1.

Данную команду необходимо настроить и выполнить в обеих обменивающих конфигурациях.

После того как Вы включили свой нетиповой документ в состав «доступных объектов», в т.ч. выполнили настройку правил обмена, Ваш документ появится на ветке AvailableObjectTypes.

В примере выполняется односторонний обмен документом «экзРапортФ114» из конфигурации Бухгалтерия 3.0 в конфигурацию «1С:ERP Управление предприятием 2». Поэтому в файле, выгруженном из «1С:Бухгалтерия 3.0» документ прописан на ветке «Sending».

А в файле, выгруженном из «1С:ERP Управление предприятием 2», документ прописан на ветке «Receiving»/

Нетиповой документ готов к обмену через типовой механизм.

Если документ не описан в XDTO-пакете, то для его включения в обмен посредством механизма «Синхронизация данных через универсальный формат» необходимо выполнить следующие процедуры:

1. Описать документ в XDTO-пакете обеих обменивающихся конфигураций.

2. Обновить записи регистра сведений НастройкиОбменаДаннымиXDTO обеих обменивающихся баз.

3. Выполнить действия для «типовых» документов (см. статью «Обмен через универсальный формат (КД 3.0): подключение типового документа», - ссылка в начале):

a. В конфигурации-источнике подключить документ в состав плана обмена «СинхронизацияДанныхЧерезУниверсальныйФормат».

b. Настроить правила обмена (КД 3.0) в обеих конфигурациях

Данный способ универсален и пригоден для любых конфигураций и любых видов объектов (Документов, Справочников и т.п.).

Задача: требуется настроить обмен данными через файл из 1С: Управление торговлей 11 (далее УТ) в 1С: Бухгалтерия 3.0 (далее Бухгалтерия).

платформа 1С: Предприятие 8.3 (8.3.13.1690),
конфигурация Управление торговлей, редакция 11 (11.4.7.150),
конфигурация Бухгалтерия предприятия (базовая), редакция 3.0 (3.0.72.72)
режим Файловый (без сжатия).

настроить параметры подключения,
настроить правила отправки и получения данных,
выполнить начальную выгрузку данных.

настроить правила отправки и получения данных,
выполнить сопоставление и загрузку данных,
выполнить начальную выгрузку данных.

ШАГ 1. Настройка в УТ

Переходим в раздел «НСИ и администрирование» и выбираем пункт «Синхронизация данных». Обязательно должен быть указан префикс информационной базы. В нашем случае это «ЦБ».

Устанавливаем флаг «Синхронизация данных» и переходим по ссылке «Настройки синхронизации данных». Нажимаем кнопку «Новая синхронизация данных». В открывшемся окне выбираем конфигурацию, с которой будем настраивать обмен. В нашем случае это «Бухгалтерия предприятия, редакция 3.0».

Откроется окно настройки синхронизации. Выберем пункт «Настроить параметры подключения».

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

Далее укажем каталог и настроим архивацию файлов.

Далее укажем префикс базы бухгалтерии и название файла с настройками синхронизации.

Обратите внимание: если указать префикс, по которому уже есть обмен, то будет ошибка, программа предложит указать уникальный код. Нажимаем «Далее» и на этом заканчивается первый шаг настройки.

В результате у нас появится два файла в указанной папке: файл с данными (Message_ЦБ_БП.zip) и файл с настройками обмена (Синхронизация данных через универсальный формат.xml). Обратите внимание: если в УТ попробовать перейти к этапу «Настроить правила отправки и получения данных», то будет ошибка.

ШАГ 2. Настройка в Бухгалтерии

Перед настройкой синхронизации в Бухгалтерии нам понадобятся два файла, созданных на предыдущем шаге. Разместим файлы Message_ЦБ_БП.zip и Синхронизация данных через универсальный формат.xml в любую папку на компьютере с базой Бухгалтерии. Внимание: если Бухгалтерия находится на одном компьютере с УТ, то ничего переносить не нужно. Будем использовать ту же папку, что и для УТ.

Сначала перейдем в раздел «Администрирование» и выберем пункт «Синхронизация данных». В открывшемся окне проверим, чтобы префикс указанной базы совпадал с префиксом, который мы указали на первом шаге.

Устанавливаем флаг «Синхронизация данных» и переходим по ссылке «Настройки синхронизации данных». Нажимаем кнопку «Новая синхронизация данных». В открывшемся окне выбираем конфигурацию, с которой будет настроен обмен. В нашем случае это «1С: Управление торговлей, редакция 11».

Откроется окно настройки синхронизации. Выберем пункт «Настроить параметры подключения».

Так как обмен настраиваем через файл, то выбираем пункт «синхронизация данных через файл, без подключения к другой программе». На Шаге 1 мы уже создали файл с настройками обмена Синхронизация данных через универсальный формат.xml, поэтому выберем его. Если был создан другой каталог и туда скопировали файл с настройками обмена, то выбираем его.

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

Далее проверяем настройки префиксов и на этом настройка параметров подключения в Бухгалтерии завершена.

Далее переходим к следующему этапу «Настройка правил отправки и получения данных».

Так как задачи выгрузки из Бухгалтерии у нас нет, то в настройках отправки данных укажем «не отправлять».

В настройках получения данных укажем типовые настройки. При необходимости можно указать свои настройки.

Нажимаем «Записать и закрыть». Далее переходим к следующему этапу «Выполнить начальную выгрузку данных».

После выполнения операции будет создан в каталоге обмена файл с данными Message_БП_ЦБ.zip. На этом этап настройка обмена в Бухгалтерии закончена.

ШАГ 3. Окончание настройки в УТ

Вернемся в УТ. Если использовался другой каталог, то в папку обмена УТ перенесем файл, созданный на прошлом шаге Message_БП_ЦБ.zip.

Продолжим настройку синхронизации в УТ с этапа «Настроить правила отправки и получения данных».

В настройках обратим внимание на два поля.

1.Отправлять только используемую в документах нормативно-справочную информацию.

2.Отправлять все, начиная с даты. Это поле полезно, так как бывает, что нужно начать синхронизацию с определенного времени. Например, учет в УТ уже был настроен ранее, а в
Бухгалтерии только начинаем вести учет. Тогда нет необходимости переносить все документы из УТ в Бухгалтерию. Или второй случай: нужно поменять настройки обмена, но чтобы они действовали только для документов с определенной даты.

Все остальные поля заполняем в зависимости от учета.

В нашем случае настройка получения данных не требуется. Оставляем ее без изменений.

Нажимаем «Записать и закрыть». Переходим к следующему этапу «Выполнить сопоставление и загрузку данных».

В нашем случае программа ничего загружать не будет и перейдет к следующему этапу.

На последнем этапе «Выполнить начальную выгрузку данных» программа выгрузит данные из УТ в файл Message_ЦБ_БП.zip.

Обратите внимание (для случая с двумя каталогами): полученный файл Message_ЦБ_БП.zip копируем в каталог обмена Бухгалтерии. В Бухгалтерии выполняем синхронизацию. При этом Бухгалтерия сначала загрузит данные из присланного файла Message_ЦБ_БП.zip, потом обновит свой файл выгрузки Message_БП_ЦБ.zip Этот файл выгрузки Message_БП_ЦБ.zip нужно скопировать обратно в каталог обмена УТ и в УТ выполнить синхронизацию. При этом УТ сначала загрузит данные (если они там есть) из файла Message _БП_ЦБ.zip, а потом обновит свой файл выгрузки Message _ЦБ_БП.zip и т.д.

Чтобы организация могла стать полноценным участником оборота алкогольной продукции, ей нужно в первую очередь подключиться к единой государственной автоматизированной информационной системе (ЕГАИС), в которой необходимо фиксировать каждый факт закупки и продажи алкоголя т.к. система изначально отслеживает движения каждой бутылкой с момента её производства на каком-нибудь заводе до фактической продажи розничному покупателю. И сегодня мы с вами пошагово узнаем, как настроить подключение к Егаис в 1С Розница 2.3.

Обратите внимание, что с 15 апреля прекращается всякая поддержка УТМ версий ниже 4.2.0, а конфигурация 1С: Розница стала поддерживать новый формат УТМ с версии 2.3.8.60 от 21.04.2021 г. Так что обязательно проверьте версию Розницы у себя и если она ниже 2.3.8.60 версии, значит обновите конфигурацию перед тем как продолжить т.к. мы будем использовать с вами именно эти версии Розницы с УТМ для подключения к системе Егаис. Итак, проверяем и, пожалуй, начинаем.

Самые распространенные крипто-ключи — JaCarta SE и Rutoken. Я предполагаю, что один из таких ключей у вас уже имеется и вам осталось установить к себе на компьютер обязательные для его корректной работы драйвера. Сейчас мы с вами для примера, установим драйвера для крипто-ключа от Рутокена. Итак, заходим на официальный сайт и в разделе Драйверы для ЕГАИС, нажимаем на Драйверы Рутокен для ЕГАИС.

Отметим согласие с условиями лиц. соглашения и нажимаем Условия приняты.

После быстрого скачивания, запускаем установочный файл rtDrivers.exe.

Отмечаем создание ярлыка на рабочем столе и нажимаем Установить.

Ожидаем быстрой установки драйверов Рутокена к нам на компьютер.

И нажимаем Закрыть.

Для проверки, вставляем крипто-ключ в свободный usb разъём на ПК, запускаем ярлык Панель управления Рутокен на рабочем столе и на вкладке Сертификаты, проверяем их наличие и срок действия.

Итак, обязательная установка драйверов для крипто-ключа прошла успешно.

Затем, нажимаем Ознакомиться с условиями и проверить их выполнение.

И нажмём Начать проверку. Как видно, у нас возникла закономерная ошибка на третьем шаге из-за того, что на компьютере нет дополнительной программной компоненты Фсрар-Крипто 3, которую, собственно, предлагается сразу скачать и установить. Так что, нажимаем на соответствующую кнопку.

И в окне с дальнейшими действиями для файла, нажимаем Выполнить.

После скачивания установочного файла, нажимаем Далее.

Затем, Установить.

И в завершении, нажимаем Готово

После чего, снова нажмём Начать проверку, которая должна увенчаться успехом и нажимаем Перейти в Личный кабинет.

Вводим стандартный пин-код от крипто-ключа, жмём Показать сертификаты.

Если появится несколько сертификатов, нажимаем на самый нижний из них.

А в окне с дальнейшими действиями для файла, просто нажать Выполнить.

Итак, обязательная установка транспортного модуля у нас прошла успешно.

Выбираем адрес осуществления своей деятельности.

Отмечаем в нижней части страницы принятие условий выдачи ключей доступа к ЕГАИС и нажимаем Сгенерировать сертификат.

После успешной записи ключа доступа на ключевой носитель, нажимаем Здесь.

И в настройках УТМ, нажимаем Обновить.

А затем, подтверждаем обновление настроек, нажатием Ок.

Итак, настройки для УТМ у нас успешно обновлены.

Теперь можно перейти к настройкам подключения к Егаис в среде 1С Розница.

Где мы уже действуем с вами, следующим образом.

Отмечаем: Алкогольная (спиртосодержащая) продукция в рознице ;
Отмечаем: Выгружать продажи немаркируемой продукции в ЕГАИС ;
Вводим дату начала розничных продаж в ЕГАИС ;
И дату начала продаж в ЕГАИС в сельской местности (если нужно) ;
Можно активировать автоматический обмен с ЕГАИС (если нужно) ;
Внимательно проверяем и нажимаем Параметры подключения к ЕГАИС.

Т.к. настроек обмена с ЕГАИС у нас ещё нет, нажимаем Создать.

И сразу же выполняем проверку подключения к УТМ, чтобы убедиться в том, что Подключение настроено корректно. После чего, жмём на синюю стрелку рядом с пунктом Код в ФСРАР, дожидаемся загрузки кода и нажмём Запросить из ЕГАИС.

Ожидаем получения ответа со стороны Егаис.

И после получения, просто нажимаем Закрыть.

И в окне организации полученной из Егаис мы поступаем, следующим образом.

Внимательно перепроверяем Данные ЕГАИС ;
Выбираем формат обмена: V4 (УТМ 4.0.2 и выше) ;
Оставляем соответствие: Собственной организации ;
Указываем организацию из базы 1С для сопоставления ;
И Торговый объект (магазин) из базы 1С для сопоставления ;
Отмечаем Находится в сельской местности (если необходимо) ;
Внимательно всё перепроверяем и нажимаем Записать и закрыть.

Перепроверяем сопоставление организаций в ИБ и нажмём Записать и закрыть.

Вот и всё, настройки обмена с Егаис у нас закончены.

И нажать Выполнить обмен, чтобы получить входящую накладную с алкоголем от поставщика и оформить его поступление.

Планы обмена используются для организации обменов данными между различными системами. Это может быть как обмен между двумя базами на платформе 1С, так и обмен между базой на 1С и какой-нибудь внешней системой, например с сайтом.

В целом план обмена похож на справочник, он обладает почти теми же самыми свойствами и методами. Поэтому в данной статье будет рассмотрена только та функциональность, которая касается обмена данными.

В пользовательском режиме создаются элементы плана обмена, которые называются узлами обмена:

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

Для плана обмена нельзя установить нулевую длину кода или наименования, так как узлы идентифицируются по коду (в файл обмена записывается код узла).

Состав плана обмена

При создании нового плана обмена нужно определить состав данных, которыми будут обмениваться системы. Например, в текущей конфигурации может быть 20 справочников, 10 документов, 5 регистров сведений, но в другую базу нужно выгружать только 5 справочников и 2 документа.

Для настройки состава плана обмена на закладке Основные нужно нажать на кнопку Состав:

Будет открыто окно, в котором можно флажками отметить те объекты, которыми можно будет обмениваться с помощью данного плана обмена:

В состав плана обмена можно включить следующие объекты:

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

Также у данных видов объектов метаданных есть закладка Обмен данными, где можно отметить те планы обмена, в состав которых будет входить данный объект метаданных:

При сохранении конфигурации базы данных для каждого из отмеченных объектов будет создана таблица с тремя колонками:

Состав данных таблиц можно посмотреть с помощью конструктора запросов. Для этого нужно нажать на кнопку Отображать таблицы изменений:

Если для разных узлов нужно обмениваться разными данными, то нужно создать несколько планов обмена. Потому что для всех узлов одного плана обмена состав объектов одинаковый.

Служба регистрации изменений

Служба регистрации изменений позволяет получить список измененных объектов для определенного узла плана обмена. В дальнейшем данный список объектов можно выгрузить в файл.

Алгоритм работы данной службы:

Для того чтобы изменения объектов автоматически регистрировались в таблицах изменений нужно при настройке состава плана обмена разрешить автоматическую регистрацию (по умолчанию она разрешена):

Рассмотрим данный алгоритм на примере.

В базе-источнике есть 3 узла плана обмена, один из которых является текущей базой (Основная база):

В состав плана обмена включен только один справочник Номенклатура и для него разрешена автоматическая регистрация:

На данный момент таблица регистрации изменений пустая:

Создадим новую номенклатуру Стул. В результате в таблицу будет добавлено 2 новые строки, по одной для каждого узла плана обмена (кроме узла текущей базы):

Создадим еще одну номенклатуру Шкаф:

В таблицу было добавлено 2 строки для шкафа.

Создадим еще одну номенклатуру Стол:

После этого была выполнена выгрузка сразу в оба узла:

Затем у стула был изменен артикул и он был перезаписан:

Из данного примера можно сделать следующие выводы:

Объект будет выгружаться в файл обмена до тех пор, пока из приемника не придет ответ (квитанция) о том, что данный объект был успешно загружен.
Если после выгрузки объекта он был изменен, то после загрузки квитанции изменения не будут потеряны.
Для каждого объекта можно узнать выгружался он или нет, но только до загрузки квитанции. После загрузки квитанции история выгрузки не сохраняется.

В данном примере был рассмотрен пример двухстороннего обмена. При этом из второй базы может выгружаться только квитанция, а может квитанция + данные.

Основной отбор регистра сведений

У регистра сведений в свойствах измерения есть флаг Основной отбор:

А если регистр сведений периодический, то на закладке Основные есть флаг Основной отбор по периоду:

По умолчанию данные флаги установлены.

С помощью них определяется минимальная гранула для регистрации на узлах плана обмена.

Если оставить как есть, то при изменении одной записи регистра сведений будет регистрироваться только она.

Если снять данный флаг у одного из измерений, то оно перестанет входить в гранулу для регистрации, в результате при изменении одной записи может зарегистрироваться сразу несколько записей.

Лучше всего объяснить на примере. Пусть есть регистр сведений со следующей структурой:

И в нем содержатся следующие данные:

Если все измерения входят в основной отбор, то при изменении оптовой цены для шкафа в таблицу регистрации попадет только одна запись, она же будет выгружена в файл обмена:

Если снять флаг Основной отбор у измерения Вид цены, то из таблицы регистрации будет удалена соответствующая колонка. В результате при изменении оптовой цены для шкафа в таблицу регистрации будет записана только номенклатура и период:

Тогда при выгрузке в файл, из регистра будут отобраны все записи, где Номенклатура = Шкаф и Период = 05.10.21, то есть сразу 2 записи: с оптовой и розничной ценой.

То же самое касается периода. Если снять флаг Основной отбор по периоду, то колонка Период будет удалена из таблицы регистрации изменений. Тогда при выгрузке в файл будут выбрана вся история изменений цены для одной номенклатуры.

Удаление объекта

При непосредственном удалении объекта из базы данных в таблицу регистрации изменений записывается объект Удаление объекта.

При выгрузке он тоже выгружается в файл обмена, затем в базе приемнике по идентификатору (для объектных данных) будет найден соответствующий объект и удален.

ЭтотУзел

Один из узлов плана обмена должен указывать на текущую базу. В списке узлов он выделяется специальной пиктограммой:

Чтобы получить текущий узел можно воспользоваться методом ЭтотУзел. Данный метод вернет ссылку на узел плана обмена:

Читайте также: