Выгрузка номенклатуры, цен и остатков из 1С в Excel, XML, YML, CSV — для маркетплейсов

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

Разработка снимает задачу целиком: выгрузка номенклатуры, цен и остатков из 1С идет в Excel, CSV, JSON и XML, в том числе готовыми фидами для Яндекс-Маркета, Kaspi, Avito, СберМегаМаркета и AliExpress. Файл сохраняется в папку, уходит на FTP, почтой, в облако или отдается по постоянной ссылке — вручную или по расписанию, без участия человека.

Профили выгрузки: несколько независимых настроек в одной базе

Все параметры хранятся в справочнике «Профили выгрузки». Профиль — это именованная настройка со своим форматом, набором колонок, отбором, приемником, расписанием и уведомлениями. Профилей столько, сколько нужно: «Прайс в Excel» для менеджеров, «Яндекс-Маркет» с ночной выгрузкой, «Avito» с дневной, «Остатки партнеру» на FTP. Профили работают независимо друг от друга — у каждого свое расписание и свой журнал.

Форма профиля разложена по вкладкам: настройки выгрузки, расписание, публикация и уведомления, а внутри настроек — отбор номенклатуры, структура файла, шапка и подвал, приемник и правила преобразования. Все команды профиля стоят в ряд кнопок над полями: выгрузить сейчас, предпросмотр, журнал выгрузок, отправка в мессенджер, экспорт и импорт настроек, справка. Готовый профиль копируется одной командой, настройки выгружаются в файл и переносятся в другую базу кнопками «Экспорт настроек» и «Импорт настроек», а результат смотрят «Предпросмотром», не создавая файла.

Форматы выгрузки номенклатуры: Excel, CSV, JSON и XML-фиды маркетплейсов

Тип файла выбирается в профиле: Excel (xlsx), CSV, JSON или XML. Для XML доступны произвольная структура и готовые схемы торговых площадок: Яндекс (YML), Kaspi, Avito, СберМегаМаркет, AliExpress.

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

Произвольный XML собирается по заданной структуре — теги называются так, как требует принимающая система.

Заголовок колонки цены и остатка задается прямо в карточке: расширение добавляет в карточку склада (в УНФ 3.0 и Рознице 3.0 — структурной единицы) и в карточку вида цен поле «Заголовок XML». Что в нем написано, то и попадет в шапку файла и в имя тега — сразу по всем профилям выгрузки. Подсистема «Дополнительные реквизиты и сведения» полю не нужна, поэтому оно работает в любой поддерживаемой конфигурации, в том числе в УНФ 3.0, где набора доп.реквизитов для видов цен нет вовсе.

Значение становится именем тега в файле, поэтому допустимы только латинские буквы, цифры и знаки «_», «-», «.», а первым символом — латинская буква или «_». Кириллицу и пробел поле не примет: карточка с таким значением не запишется и подскажет, что можно, — вместо файла, который принимающая сторона не разберет.

Поле необязательное. Если «Заголовок XML» не заполнен, заголовок берется по-старому: сначала дополнительный реквизит, выбранный на вкладке настройки в поле «В заголовок» рядом со складом и видом цен, а если и он не задан — наименование объекта (в XML вид цен подписывается так, как принято в конфигурации: наименованием в УТ, КА и ERP, комментарием из карточки в УНФ 3.0 и Рознице 3.0, идентификатором в Рознице 2.3). Поле «В заголовок» остается ради профилей, настроенных раньше: заполненный «Заголовок XML» из карточки всегда старше доп.реквизита. Если доп.реквизит выбран, но у объекта не заполнен, выгрузка прерывается сообщением «Не найдено значение доп.реквизита для определения заголовка …» — в этом случае достаточно заполнить «Заголовок XML» или очистить поле «В заголовок» в профиле.

Для сайта и внутренних сервисов удобнее JSON: массив объектов с ценами, остатками по складам, штрихкодами и группами.

Для Яндекс-Маркета формируется YML-каталог с магазином, валютами, деревом категорий, условиями доставки и товарными предложениями. Ссылка на карточку товара и адрес картинки берутся из дополнительных реквизитов номенклатуры, а свойства для фильтров на площадке уходят параметрами предложения. Отдельно указывается, какой вид цены считать основным, а какой — старой ценой для перечеркнутого ценника.

Для Kaspi собирается каталог с company, merchant ID и наличием по торговым точкам. Идентификатор точки площадки хранится в дополнительном реквизите склада и подставляется в фид автоматически.

Куда уходит файл: папка, FTP, почта, Яндекс.Диск, S3 и Google Drive

Приемник задается в профиле и определяет, что произойдет с готовым файлом:

• Папка на диске или в сетевом каталоге;
• FTP и FTPS — адрес, папка, логин и пароль;
• E-mail — письмо с вложением, получателей можно перечислить через точку с запятой;
• Яндекс.Диск по OAuth-токену;
• S3 — endpoint, bucket, регион и ключи доступа, подпись AWS V4;
• Google Drive и Google Таблицы — с опцией конвертации файла в таблицу;
• только HTTP-публикация — файл никуда не копируется, а отдается по постоянной ссылке.

Имя файла настраивается, дату можно добавлять автоматически. Перед отправкой файл при необходимости упаковывается в ZIP. При сбое сети доставка повторяется заданное число раз с паузой, а после успешной выгрузки на указанный адрес уходит вебхук с JSON о результате — принимающая система узнает о новом файле сразу.

Постоянная ссылка на последний файл профиля защищена: у токена задается срок действия, а доступ ограничивается белым списком адресов — точным IP, префиксом или маской подсети вида 192.168.0.0/16. По той же публикации отдаются картинки номенклатуры по HTTP-ссылкам, если фид требует адрес изображения, а не сам файл.

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

У каждого профиля свое расписание — обычный диалог регламентного задания 1С. Один профиль уходит ночью, другой каждые полчаса; профиль с флагом «Активен» подхватывается заданием автоматически. О результате можно узнавать, не заходя в базу: уведомление приходит на почту и в мессенджер через Green API (WhatsApp, Telegram, Макс), а режим «только при ошибке» присылает сообщение лишь тогда, когда выгрузка не удалась.

Каждая выгрузка пишется в журнал: профиль, время, признак успеха, количество строк, текст ошибки. Журнал хранит заданное число последних файлов — сформированный файл скачивается из журнала прямо в базе, даже если он давно ушел на FTP. Сводная картина по всем профилям собирается отчетом-дашбордом, а ошибки дополнительно попадают в журнал регистрации.

Что можно отобрать и пересчитать перед выгрузкой

Отбор строится по любому реквизиту номенклатуры — значения выбираются из списка, а не вводятся руками. Поверх работают бизнес-фильтры: не выгружать позиции без цены, без картинки, без штрихкода, а также отсечь все, что ниже минимального остатка. Инкрементальный режим отдает только то, что изменилось с прошлого раза, — если изменений нет, файл не формируется; состояние дельты сбрасывается кнопкой.

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

Поля профиля: что меняет каждое и что будет, если оставить пустым

Обязательных полей в профиле немного, у остальных есть разумное умолчание — но знать его полезно. Доступные реквизиты — отметки колонок будущего файла: если не отмечено ни одной, выгрузка останавливается с сообщением «Не отмечены реквизиты для выгрузки» (исключение — фиды маркетплейсов, у них своя структура). Название и характеристика вместе склеивает наименование с характеристикой в одну колонку; снят — характеристика идет отдельным полем. Заголовок XML — новый реквизит карточки склада и вида цены: пусто — заголовок берется как раньше. Старая цена задает вид цены для перечеркнутой цены в фидах: не заполнено — тега oldprice в файле не будет вовсе.

Отбор по номенклатуре пуст — выгружается вся номенклатура, отбор ничего не сужает. Флаги Только товары с ценой, Только товары с картинкой, Только товары со штрихкодом и Только в наличии на складе сняты по умолчанию: ни одна позиция не отсекается. Минимальный остаток пуст или ноль — по остатку ничего не отсекается, порог начинает работать только с положительного значения. Реквизиты номенклатуры — это сама таблица отмеченных колонок профиля, ее состав и задает порядок полей в файле. Правила преобразования полей — пустая таблица означает, что значения уходят в файл как есть; у каждой строки правила обязателен Тип правила (наценка, округление, замена, префикс, суффикс) — с пустым типом строка молча ничего не делает.

Куда выгружать не выбрано — файл кладется в папку, причем в клиент-серверной базе путь считается от сервера, а не от компьютера пользователя. Число повторов при ошибке пусто или 0 — приемник получит ровно одну попытку, а Пауза пустая или нулевая означает повтор сразу же, без выдержки. Хранить файлов в журнале пусто или 0 — сами файлы в журнале не остаются, только записи о выгрузках. Основная цена не заполнена — цена не читается вовсе, а Строка на каждый код SKU снят: позиция уходит одной строкой, коды SKU перечисляются в ней через запятую. FTPS снят — соединение идет обычным FTP, порт по умолчанию 21. Для S3 обязательны Адрес (endpoint), Бакет, Access Key и Secret Key: пропустите любое — в протоколе появится «S3-хранилище: не заполнены обязательные реквизиты» и файл не уйдет; Регион пустым читается как us-east-1, а пустая Папка (префикс) означает корень бакета. Пустой ID папки на Диске — файл ляжет в корень Google Drive.

Реквизиты доступа у облачных приемников свои, и пустыми они не работают: для Яндекс.Диска это OAuth-токен и Папка на Диске (пустая папка — корень Диска), для Google Drive — Client ID, Client Secret и Refresh Token; не заполнен любой из них — доставка не начинается, а в протоколе остается строка о незаполненных реквизитах. Конвертировать в Google Таблицу снят по умолчанию: файл ложится на Диск тем форматом, который выбран в профиле. Для приемника E-mail нужна Учетная запись, для писем-уведомлений — Учетная запись почты: пустые — письмо просто не уходит, сама выгрузка отрабатывает. Токен действует до пусто — ссылка HTTP-публикации бессрочна. Только измененные — режим дельты: снят, и каждый раз выгружается весь отобранный список. В таблице правил преобразования Параметр — это значение правила (процент наценки, кратность округления, текст замены или приставки): пустое значение оставляет строку правила без действия.

Расписание выполнения не задано — профиль отрабатывает при каждом срабатывании общего регламентного задания, поэтому расписание стоит задать явно. Публиковать картинки по ссылке (HTTP) снято — поле ссылки на картинку останется пустым во всех форматах. Разрешенные IP пусты — ссылка открывается с любого адреса. Для мессенджера обязательны Телефоны получателей (пусто — «не заданы получатели»), а Хост API и Хост медиа пустыми подставляются штатными api.green-api.com и media.green-api.com.

Совместимость и состав поставки

Расширение работает в «Управлении торговлей» 11.4 и 11.5, «Комплексной автоматизации» 2.4 и 2.5, «1С:ERP Управление предприятием 2» 2.4 и 2.5, «Рознице» 2.3 и 3.0, «Управлении нашей фирмой» 1.6 и 3.0. В архиве лежат готовые файлы под каждую линейку, разложенные по папкам с названиями конфигураций. Если файл подключат не в ту конфигурацию, расширение само предупредит об этом и назовет правильный файл из архива.

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