В статье представлено расширение для 1С, которое автоматически заполняет обязательные XML-поля (теги) в Электронной транспортной накладной (ЭТРН) в соответствии с требованиями крупных торговых сетей.
На текущий момент реализованы сценарии заполнения для следующих сетей (список расширяется):
- «Гиперглобус»
- «Х5»
- «ВСЕИНСТРУМЕНТЫ.РУ»
- «ТАНДЕР»
- «МЕТРО»
- «Дикси»
- «АШАН»
- «Максидом»
- «Комус»
- «ОЗОН» (ООО «Интернет Решения» [схема FBО - работает; схема FBS - будет в релизе 1.4.] )
- «ДНС РИТЕЙЛ»
Расширение автоматически формирует следующие теги на основании данных из 1С:
- ГЛН получателя //Файл/Документ/СодИнфГО/СвГП/АдресДостГр/ГЛН (тег ГЛН)
- ГЛН отправителя //Файл/Документ/СодИнфГО/СвПогруз/ФАдресПогр/ГЛН (тег ГЛН)
- Сопроводительные документы //Файл/Документ/СодИнфГО/СопрДок/ДокПерЦенн
- Номера и даты инфополей //Файл/Документ/СодИнфГО/ИнфПол/ТекстИнф
Поддерживаемые идентификаторы ИнфоПолей <ИнфПол>(список расширяется):
- ORDERS и ORDERS_DATE
- DESADV
- INVOIC и INVOIC_DATE
- Код_Поставщика
- *Прочие специфические ИнфоПоля торговых сетей.
Расширение автоматически подстраивает структуру XML под требования конкретной торговой сети (определяется по ИНН):
- Для большинства сетей (Х5, ДНС, Гиперглобус, Лента, Окей и др.) каждый номер заказа или поставки (
ORDERS,DESADV) записывается в отдельный, собственный тег,<ТекстИнф>и это реализовано в расширении. Количество таких тегов равно количеству документов реализации, подобранных в транспортную накладную. См рис. в конце статьи с демонстрацией XML-выгрузки. - Исключением является сеть «ТАНДЕР» (Магнит). Согласно ее технической спецификации, расширение автоматически объединяет все номера в одном теге
<ТекстИнф>через запятую без пробелов.
Важно: Текущая версия расширения заполняет только дополнительные поля, специфичные для требований торговых сетей. Оно не заполняет базовые обязательные поля самой ЭТРН, такие как «Водитель», «Транспортное средство», «Описание груза» и т.д. Эти данные необходимо вводить вручную или заполнять на основании Электронного заказ-наряда (ЭЗЗ). Автоматизация базовых полей планируется в будущих версиях.
Принцип работы расширения:
- Пользователь создает и первично сохраняет ЭТРН.
- Подбирает документ «Транспортная накладная» (ТН), в котором уже собраны все данные по перевозимым отгрузкам (перечислены документы реализации).
- Пользователь нажимает кнопку «Заполнить сопроводительные документы и доп. реквизиты».
- Расширение анализирует ИНН грузополучателя, определяет нужный сценарий заполнения (предопределенный для конкретной сети), собирает данные из связанных документов 1С и записывает их в соответствующие теги ЭТРН.
- Готовая ЭТРН отправляется грузополучателю стандартными механизмами 1С, либо выгружается в XML-файл для отправки через стороннего оператора ЭДО.
Откуда расширение берет данные:
Для корректной работы в информационной базе должны быть заполнены определенные реквизиты.
Ниже приведена карта данных:
|
Требуемый тег |
Источник данных в 1С |
|
|---|---|---|
| ORDERS |
|
|
| ORDERS_DATE | Документ «Заказ клиента» (стандартное поле "Дата заказа по данным клиента) | |
| DESADV | Дополнительный реквизит, который расширение автоматически добавляет в документ «Заказ клиента». | |
| INVOIC | Номер УПД (из документов «Реализация и Счет-фактура выданный» подобранных в основании ТН) | |
| INVOIC_DATE | Дата УПД (из документов «Реализация и Счет-фактура выданный» подобранных в основании ТН) | |
| Код_Поставщика | Дополнительный реквизит, настраивается в регистре сведений «Настройки грузоотправителей и грузополучателей» | |
| ГЛН | Дополнительный реквизит, настраивается в регистре сведений «Настройки грузоотправителей и грузополучателей» | |
| ДокПерЦенн | В ЭТРН автоматически заполняется таблица «Сопроводительные документы», в нее собираются данные по УПД и ORDERS и ставится информация по подписантам. *Нужно для ООО «Гиперглобус» |
Имея ссылку в ЭТРН на ТН, а в ТН ссылки на документы реализации, расширение собирает описанную информацию и корректно разносит её в ЭТРН и далее 1с собирает данные в XML выгрузку.
Важно: Порядок заполнения информационных данных для ЭТРН после подключения расширения:
После подключения расширения в конфигурации появятся новые элементы для работы с ЭТРН. Для корректной работы необходимо выполнить следующие действия:
1. Заполнение номера DESADV в заказах. В документ «Заказ клиента» будет добавлен дополнительный реквизит «Номер DESADV для ЭТРН».
- Где найти: в форме заказа клиента, на вкладке «Дополнительно».
- Что делать: в это поле необходимо указывать номер соответствующего DESADV.
2. Настройка ГЛН Грузоотправителя и Грузополучателя. В базе будет создан регистр сведений «Настройки грузоотправителей и грузополучателей».
- Где найти: открыть можно непосредственно из формы документа «ЭТРН», ссылка под кнопкой заполнения или через меню «Все функции» (раздел для технических специалистов «Регистры сведений - Настройки грузоотправителей и грузополучателей»).
- Что делать: в данный регистр необходимо внести справочные данные:
- Ссылки на грузоотправителей и грузополучателей (подбор из справочника Контрагенты или Организации).
- ГЛН всех грузополучателей и грузоотправителей;
- Код поставщика (на текущий момент есть смысл заполнять только для сети «ГиперГлобус»).
Пошаговый сценарий работы пользователя, на примере Х5:
Подготовительные действия:
- Установить расширение, снять галочку «Безопасный режим». По результату установки и после перезапуска 1с будет выдано окно с подтверждением что настройки выполнены. Установку и перезапуск 1с нужно делать только под пользователем с полными правами.
- В заказ клиента вносим информацию по DESADV.
- В регистр настроек «Настройки грузоотправителей и грузополучателей» вносим данные по ГЛН и коду поставщика (опционально). Доступ к настройкам по ссылке из ЭТРН.
- ВАЖНО! Всем пользователям функционала «Электронные передаточные документы» необходимо назначить роль «Настройки еил_ЭТРН_ПолныйДоступ».
Шаг 1. Создание и запись ЭТРН
Создаем документ ЭТРН, заполняем обязательные базовые данные (вручную или из ЭЗЗ) и записываем его. Документ готов к подгрузке дополнительных полей:
Шаг 2. Подбор Транспортной накладной и заполнение по кнопке
Подбираем ТН, которая содержит ссылки на реализации к отгрузке. Применительно к Х5: реализации должны быть на основании «Заказа клиента», в котором заполнены поля «Номер заказа» (для ORDERS) и новое поле DESADV. В регистре настроек должен быть введен ГЛН и опционально код поставщика. Нажимаем кнопку «Заполнить сопроводительные документы и доп. реквизиты». Получаем результат:
Результ заполнения инфополей и сопроводительных документов.
Шаг 3. Контроль и проверка выгрузки
Перед отправкой можно проверить корректность формирования XML. Сам факт успешной выгрузки (меню "Еще" - "Выгрузить") уже говорит о том, что данные в ЭТРН структурированы верно. Сохраните XML-файл на диск и откройте его в «Блокноте» или любом редакторе кода, чтобы визуально проверить наличие и заполнение тегов.
Выгрузка ЭТРН в XML-файл
Р
Теги ИнфПол/ТекстИнф. Каждое инфоПоле ORDERS, DESADVв отдельном теге.
Указание ГЛН -ов в тегах: АдресДостГр,ФАдресПогр (в расширении ФАдресПогр тоже реализован, на рисунке не показан)
Итог: Полученный заполненный ЭТРН сохраняем в базе по кнопке «Записать», после чего его можно отправить Грузополучателю по кнопке «Отправить».
Особенности настройки собираемых в ЭТРН тегов:
Настройки собираемых тегов для каждой сети хранятся в справочнике «Справочник настроек тегов для ЭТРН». В нем перечислены ИНН грузополучателей и требуемые для них теги.
В общем случае редактировать эти настройки не нужно. При первом запуске расширения настройки заполняются автоматически.
Уточнение по сети «Х5». Если вам необходимо обрабатывать ИНН, которого нет в списке по общему правилу Х5, вы можете отредактировать существующие строки (выделено на рис. ниже) или скопировать их и указать нужный ИНН.
Обратите внимание: Сами значения имен тегов (например, ORDERS, DESADV) редактировать не следует. Можно использовать только те имена тегов, которые предусмотрены первичной настройкой, однако их комбинации могут быть любыми. Справочник не выведен в основной интерфейс, доступ к нему осуществляется через команду «Все функции».
Что дальше?
📦 Мы продолжаем развивать расширение. В ближайшем обновлении появятся новые сценарии заполнения Инфополей и других тегов для дополнительных торговых сетей и маркетплейсов. Не нашли нужную площадку? Напишите в комментариях, и мы добавим её в план доработок.
📄 Также, скоро в открытом доступе. В ближайшее время мы выложим для бесплатного скачивания подробную документацию (Word) с описанием требований всех поддерживаемых расширением торговых сетей и примерами XML-выгрузок.
Информация по релизам:
- 01.09.26, 09:00: Первичная публикация расширения. Файл доступен для скачивания.
- 01.09.26, 18:00: Выявлена ошибка, файл временно снят с публикации для исправления.
- 02.09.26, 09:00: Ошибка устранена, файл снова доступен для скачивания.
- 📌 Внимание: Если вы успели скачать расширение в период с 01.09.26 по 02.09.26 09:00, пожалуйста, удалите старую версию из 1С и загрузите актуальный файл заново! 💡Повторное скачивание доступно бесплатно в течение 30 дней с момента вашей первой загрузки.
- 07.09.26 09:00: Расширение обновлено до версии 1.2.
- Добавлены сценарии заполнения для «Тандер» (формат с объединением значений в одном теге), «Метро», «Дикси», «ОЗОН», «Максидом».
- 14.09.26 09:00 Расширение обновлено до версии 1.3.
- Добавлены сценарии: «АШАН», «Комус».
- В транспортной накладной теперь обрабатываются не только документы «Реализации», но и «Передачи на комиссию».
- Улучшена работа с ролями. Теперь достаточно назначить роль «Настройки еил_ЭТРН_ПолныйДоступ» только пользователям работающим с ЭТРН.
- 📌Рекомендуем обновиться, даже если новые сценарии Вам пока не нужны. В этом релизе мы оптимизировали ряд внутренних механизмов расширения, что положительно скажется на стабильности и скорости работы. Установка займёт пару минут, а польза — ощутимая.
- Порядок обновления, если вы уже установили расширение ранее:
- 17.09.26 Уточнение по «ОЗОН»: сейчас в расширении готово только требование FBO; схема FBS - скоро будет добавлена.
Проверено на следующих конфигурациях и релизах:
- 1С:Комплексная автоматизация 2, релизы 2.5.27.79, 2.5.22.186
- Управление торговлей, редакция 11, релизы 11.5.27.70, 11.5.22.186
Вступайте в нашу телеграмм-группу Инфостарт
