Документация Eofferix

JSON от поставщика: загрузка, снапшот и преобразования Как Eofferix принимает JSON-файлы и JSON-ответы, строит снапшот уникальных узлов и преобразует данные в XML, таблицы, другой JSON или импорт. Читать Глоссарий Eofferix Короткое объяснение основных терминов сервиса: источник, профиль, шаблон, снапшот, интерпретация, кредиты, сводный каталог и SKU. Читать Как устроен рабочий процесс Eofferix Общая схема: источник данных, профиль интерпретации, запуск обработки, результат или загрузка в сводный каталог. Читать Разделы кабинета и назначение каждого раздела Краткое описание навигации: Интерпретатор, Источники, Файлы, Планировщик, Архив, Оплата и Сводный каталог. Читать Регистрация и вход в кабинет Как попасть в рабочий кабинет, восстановить пароль и где начинается настройка сервиса. Читать

FTP / FTPS источник Как настроить получение файла с FTP/FTPS: протокол, хост, порт, путь, маска файла, логин и пароль. Читать Google и облачные источники Как подключать Google Sheets, Google Drive и другие облачные файлы, если модуль включен в аккаунте. Читать Schema Guard: защита структуры источника Что означает изменение структуры источника, как принять новую структуру или оставить текущую рабочую версию. Читать URL-источник Как получать файл по ссылке: метод запроса, авторизация, заголовки, проверка доступа и повторная загрузка. Читать Защита от смены структуры источника Как работает контроль колонок и узлов, строгая сигнатура и ручное принятие новой структуры. Читать Импорт данных из 1С / CommerceML Как подключить выгрузку из 1С по CommerceML: URL обмена, логин и пароль источника, режим сборки, документы import/offers/prices/rests и автосборка. Читать Источник: 1С / CommerceML Как принимать выгрузку CommerceML от 1С по выделенному URL с логином и паролем. Читать Источник: FTP или FTPS Как подключить файл поставщика по FTP/FTPS, логину, паролю и пути к файлу. Читать Источник: Google Таблицы Как подключить публичную или закрытую Google Таблицу по ссылке, листу и service account. Читать Источник: Яндекс Таблицы Как читать данные из Яндекс Таблиц по ссылке, имени листа и OAuth-токену. Читать Источник: загрузка файла с компьютера Как создать источник из файла XML, CSV, JSON, XLS, XLSX или XLSM. Читать Источник: получение вложений из почты по IMAP Как настроить почтовый ящик, фильтры писем и правила обработки вложений. Читать Источник: ссылка с авторизацией Как получить файл из закрытого кабинета через форму входа, Basic-авторизацию или Bearer-токен. Читать Источник: файл Google Drive Как подключить файл или папку Google Drive как источник данных. Читать Источник: файл Яндекс Диска Настройка файла или публичного ресурса Яндекс Диска как источника. Читать Источник: файл по прямой ссылке Как забирать XML, CSV, JSON или Excel-файл по открытой ссылке поставщика. Читать Как загрузить XML каталог поставщика Настройка источника для XML-каталогов поставщиков: загрузка, проверка структуры и дальнейшая передача в профиль или сводный каталог. Читать Как подготовить CSV/XLSX прайс-лист поставщика Практическая настройка табличного прайс-листа: источник, табличный снапшот, строки заголовков, строки-разделы, колонки, фильтры, новые поля, переменные и преобразования цен. Читать Новый источник Общий сценарий создания источника: тип подключения, параметры, получение файла и сохранение рабочей версии. Читать Периодичность загрузки источника Настройка cron-полей, быстрых сценариев и окончания расписания для источника. Читать Почтовый источник Как получать вложения из почты через IMAP: провайдер, папка, фильтр писем, маска вложения и пароль приложения. Читать Разметка таблиц в источнике Как настроить листы XLSX/CSV: строка заголовков, пропуск строк, исключение листов и объединение листов. Читать Разметка таблицы источника Как выбрать строку заголовков, исключить строки и листы, объединить листы XLS/XLSX/CSV. Читать Редактирование источника Какие блоки есть в карточке источника: подключение, получение файла, разметка таблиц, защита структуры, расписание и уведомления. Читать Ручная загрузка файла Как загрузить XML/YML/CSV/JSON/XLSX/ZIP вручную, заменить файл и учитывать ограничения размера и хранения. Читать Список источников Как читать список источников: статусы, ручное обновление, переход в карточку, архивирование и удаление. Читать Уведомления источника Какие события источника отправляются на почту и как настроить отправителя. Читать Хранение версий источника и повторные попытки Как управлять количеством версий, удалением в полночь UTC, тайм-аутом и числом попыток. Читать Что делать, если поставщик меняет структуру файла Если поставщик переименовал колонки, изменил вложенность XML/JSON или убрал поле, старые правила профиля могут перестать попадать в нужные данные. Читать

Выбор источника в профиле Чем отличаются новый файл, существующий источник и сводный каталог как источник данных. Читать Как настроить имя итогового файла Имя результата помогает отличать выгрузки по получателю, дате, источнику и назначению. Читать Один источник — несколько экспортов Как использовать один и тот же источник для сайта, поставщика, дистрибьютора и маркетплейса без повторной загрузки данных. Читать Отдельные профили выдачи для разных получателей Как из одного источника или каталога сделать несколько результатов для сайта, ERP, B2B и партнеров. Читать Профиль Wildberries API Назначение автоматической интеграции Wildberries через API. Читать Профиль Wildberries Excel Как подготовить Excel-файл Wildberries из источника Eofferix. Читать Профиль для Excel-шаблона Ozon Как использовать шаблон Ozon из кабинета продавца и заполнить его данными источника. Читать Профиль загрузки в сводный каталог Как настроить импорт товаров, предложений и разделов в сводный каталог. Читать Создание профиля интерпретации Как создать профиль, выбрать источник и шаблон результата. Читать Шаблоны интерпретации и форматы результата Какие шаблоны доступны: XML, JSON, CSV, XLS, XLSX, Ozon, Wildberries и сводный каталог. Читать

CSV/XLSX прайс-лист: типовой сценарий Как настроить обработку прайс-листа: листы, строка заголовков, пропуск строк, цены, остатки и картинки. Читать JSON-редактор: объекты, массивы и поля Как настроить JSON-результат, выбрать пути источника и обработать значения. Читать XML-редактор: базовая настройка структуры Как собрать XML-результат из входного файла и настроить элементы, атрибуты и значения. Читать XML/YML от поставщика: загрузка, снапшот и преобразования Как Eofferix принимает XML/YML-файлы и ответы, строит снапшот элементов и атрибутов и преобразует данные в JSON, таблицы, другой XML/YML или импорт. Читать В чем разница между оператором "не выгружать поле" в блоке "Преобразования" и настройкой в блоке "Условия выгрузки" при выборе "Условие для поля" Когда использовать условия выгрузки, а когда действие "не загружать поле" в цепочке преобразований. Читать Группировка данных и массивы результата Как группировать элементы по ключу и собирать вложенные массивы. Читать Дата и время в настройках преобразования Как вставлять текущую дату, форматировать дату из источника и выбирать часовой пояс. Читать Действия преобразований: что делает каждый оператор Справочник действий в блоке "Преобразования": замена, очистка текста, регистр, даты, математика, пропуск, не загружать и табличные стили. Читать Дополнительные настройки поля результата Что находится в дополнительных настройках: переменные, несколько значений, файлы, изображения и справочники. Читать Дубли, пропуски и действие Не загружать Как обрабатывать повторяющиеся элементы и исключать данные из результата. Читать Интерпретация и экспорт Как запускать демо и полный экспорт, читать расчет кредитов, очередь, прогресс и результат. Читать Интерфейс настроек значения в шаблоне Как устроено окно настроек поля, столбца или узла: преобразования, предпросмотр, условия и дополнительные параметры. Читать Источник данных в профиле Как выбрать существующий источник для профиля или создать новый источник прямо из мастера шаблона. Читать Как безопасно тестировать шаблон Как использовать предпросмотр, демо-запуск и ограниченную выборку, чтобы не тратить лишние кредиты и не выпускать ошибочный результат. Читать Как выбрать максимальный размер водяного знака Максимальный размер водяного знака ограничивает ширину и высоту накладываемого изображения. Читать Как выбрать разделитель ссылок на изображения Разделитель показывает сервису, где заканчивается одна ссылка на изображение и начинается следующая. Читать Как использовать значения из соседних полей Значение одного поля можно использовать при настройке другого: например собрать название из бренда, модели и цвета. Читать Как использовать системные переменные даты, времени и номера запуска Системные переменные подставляют служебные значения без ручного ввода: дату запуска, время, номер запуска или технический идентификатор. Читать Как конвертировать изображение в WEBP, PNG или JPG Конвертация меняет формат изображения под требования сайта, маркетплейса или внутреннего каталога. Читать Как менять размер изображения перед сохранением Ограничение размера уменьшает вес картинок и приводит их к требованиям сайта или маркетплейса. Читать Как наложить водяной знак и выбрать его положение Водяной знак помогает защитить изображения или добавить бренд перед публикацией. Читать Как настроить качество изображения Качество влияет на вес файла и визуальную четкость изображения. Читать Как настроить наценку, скидку и минимальную цену Ценовые правила позволяют пересчитать закупочную цену в продажную без ручных формул в таблице. Читать Как не скачивать изображение повторно, если оно не изменилось Повторное скачивание одинаковых изображений тратит время, место и кредиты. Eofferix может переиспользовать уже обработанный файл. Читать Как нормализовать пробелы, переносы строк и спецсимволы Поставщики часто присылают значения с двойными пробелами, невидимыми символами, переносами строк и лишними знаками. Читать Как обрабатывать PDF, Excel, архивы и видео как медиа-файлы Не все ссылки в полях являются картинками. Это могут быть инструкции PDF, Excel-прайсы, ZIP-архивы или видео. Читать Как обрабатывать ссылки на изображения в поле Если поставщик присылает URL изображений, Eofferix может скачать файл, обработать его и заменить ссылку на новую публичную ссылку результата. Читать Как округлять цены и коэффициенты Округление приводит числовые значения к нужной точности: до целых, до копеек, до десятков или по правилам получателя. Читать Как отключить поле без удаления настройки Иногда поле нужно временно убрать из результата, но сохранить все его правила на будущее. Читать Как очищать телефон, артикул или штрихкод регулярным выражением Регулярное выражение помогает убрать лишние символы из кодов: пробелы, скобки, дефисы, текстовые приставки. Читать Как преобразовывать даты поставщика в нужный формат Поставщик может присылать даты как 31.12.2025, 2025-12-31, 31/12/25 или текстом. Получателю часто нужен один строгий формат. Читать Как приводить текст к верхнему или нижнему регистру Регистр текста влияет на коды, бренды, названия и значения справочников. Читать Как пропускать строки с нулевой ценой или пустым остатком Некоторые строки не должны попадать в результат: например товары без цены, без остатка или без обязательного артикула. Читать Как работает действие "Не загружать" Действие "Не загружать" останавливает выгрузку значения, поля, строки или элемента по заданному условию. Читать Как работают условия выгрузки поля Условие выгрузки решает, попадет ли конкретное поле в итоговый файл. Читать Как разбить одно поле на несколько значений Одно поле может содержать несколько значений: теги через запятую, ссылки через пробел, размеры через точку с запятой. Читать Как скачать несколько изображений из одного поля Одно поле может содержать несколько ссылок на изображения. Сервис может разобрать их, скачать каждую и собрать результат обратно. Читать Как собрать вложенный XML-элемент Вложенный XML-элемент нужен, когда принимающая система ожидает структуру вроде product > price или offer > images > image. Читать Как собрать массив в JSON-результате Массив в JSON нужен, когда у товара, заказа или клиента есть несколько повторяющихся значений: картинки, позиции, теги, склады. Читать Как соединить несколько значений в одно поле Соединение значений помогает собрать одно итоговое поле из нескольких колонок или частей JSON/XML. Читать Как сохранить оригинальные имена изображений Оригинальные имена помогают связывать изображения с поставщиком, товаром или архивом 1С. Читать Курс валюты в настройках преобразования Как вставлять курс валюты в правила, служебные значения и расчеты цен. Читать Мэппинг полей источника Как сопоставлять поля поставщика с моделью результата или сводного каталога. Читать Настройки преобразований в XML, JSON и таблицах: что отличается Какие настройки общие для всех редакторов, а какие зависят от XML, JSON или табличного результата. Читать Обработка изображений и медиа-ссылок Как работать с изображениями, сохранять результат на сервисе и учитывать стоимость обработки. Читать Переменные и системные значения Как использовать текущую дату, валюту, курсы и пользовательские переменные в правилах. Читать Планировщик повторяющихся полей для таблиц Как собрать повторяющиеся группы XML/JSON в удобные столбцы таблицы. Читать Повторяющиеся значения в настройках преобразования Как обрабатывать несколько значений в одном поле, повторяющиеся узлы и разбиение строк. Читать Порядок обработки значения: условия, справочник, преобразования, медиа В каком порядке сервис проверяет условия, подставляет справочник, применяет правила и обрабатывает файлы. Читать Построение пути разделов из справочника Как собрать полный путь категории по ID, названию и parent_id из справочника разделов. Читать Предпросмотр и тестовый запуск профиля Как проверить результат до рабочего запуска и что смотреть в предпросмотре. Читать Преобразования значений Как менять данные перед выгрузкой: замены, очистка текста, цепочки правил, расчеты, значения по умолчанию и новые поля. Читать Преобразования значений: как читать правило Как устроена строка преобразования: что проверяется, когда правило срабатывает, что меняется и как проверить результат. Читать Прозрачность водяного знака Как настроить прозрачность водяного знака для изображений: диапазон 0.05-0.50, размер, положение и проверка результата. Читать Скачивание результата и логи запуска Где найти итоговый файл, историю запусков, ссылку на скачивание, технический лог и повторный запуск. Читать Создание шаблона интерпретации Общий путь работы в Eofferix: выбрать источник, настроить шаблон, проверить снапшот и запустить экспорт. Читать Сопоставить по справочнику Как подставить значение из справочника по ID в текущем элементе или строке. Читать Строки-разделы в таблицах: как разнести товары по разделам Как включить строки-разделы в XLSX, XLS и CSV, чтобы строки с названиями групп не попадали в товары, а товары ниже получали путь раздела. Читать Табличный редактор CSV/XLS/XLSX Как собрать плоский или многолистовой табличный результат. Читать Условия в преобразованиях: когда правило срабатывает Подробно о проверках "равно", "содержит", "пустое", "больше", регулярных выражениях и условиях для поля или элемента целиком. Читать Условия выгрузки в настройках значения Как настроить условия для поля, ячейки, строки или элемента и чем они отличаются от обычных преобразований. Читать Условия экспорта полей и строк Как включать или исключать данные по значениям источника. Читать Что происходит после запуска профиля Как профиль попадает в очередь, чем демо-запуск отличается от полного, где смотреть статусы, кредиты, логи и результат. Читать

Источники для импорта в сводный каталог Как выбрать источник данных при создании профиля импорта в сводный каталог: новый файл, существующий источник, источник из менеджера источников или другой сводный каталог. Читать Как выгрузить сводный каталог обратно во внешний источник или маркетплейс После сборки каталога данные можно использовать для файлов, внешних систем, маркетплейсов или партнерских каналов. Читать Как импортировать CSV/XLSX в сводный каталог Табличный источник удобен для прайс-листов, остатков, справочников и файлов поставщика в Excel. Читать Как импортировать JSON-каталог в сводный каталог Как загрузить JSON-источник в сводный каталог: источник данных, профиль импорта, XML-интерфейс настройки, идентификация, правила импорта и преобразования. Читать Как импортировать JSON в сводный каталог JSON-источник может хранить товары как массив объектов, вложенные предложения, склады, изображения и характеристики. Читать Как импортировать XML в сводный каталог Сводный каталог собирает данные поставщиков в единую товарную структуру. XML и YML часто встречаются в прайс-листах поставщиков и выгрузках ERP-систем. Читать Как настроить дерево разделов каталога Практический путь по настройке структуры разделов в сводном каталоге: где открыть экран, как работать с деревом и таблицей, создавать, редактировать, скрывать и сортировать разделы. Читать Как работать со справочниками значений в каталоге Справочник помогает хранить значения единообразно: например цвета, размеры, бренды, статусы или типы товаров. Читать Как работают правила итогового остатка в каталоге Остаток может приходить от разных поставщиков, складов и предложений. Правила определяют, что считать доступным количеством. Читать Как работают правила итоговой цены в каталоге Если у товара есть несколько поставщиков или предложений, каталог должен понять, какую цену считать итоговой. Читать Как скрывать, перемещать и сортировать разделы каталога Раздел можно временно скрыть, переместить выше или ниже и изменить порядок в дереве. Читать Как собрать итоговую цену из нескольких поставщиков Как настроить группы цен, приоритеты, минимальную, среднюю или расчетную цену в сводном каталоге. Читать Как собрать итоговый остаток из нескольких складов Как настроить группы остатков, приоритеты, суммирование и доступность товара в сводном каталоге. Читать Как сопоставить поля источника с товарами и предложениями каталога Сопоставление говорит сервису, какое поле источника является названием товара, артикулом, ценой, остатком, изображением или свойством. Читать Как устроен сводный каталог Практический обзор сводного каталога Eofferix: товары, торговые предложения, разделы, источники, таблица, фильтры и основные действия. Читать Карточка предложения в сводном каталоге Как читать карточку SKU/предложения: связь с товаром, цены, остатки, свойства и источники. Читать Карточка товара в сводном каталоге Какие данные есть в карточке товара: основные поля, изображения, разделы, источники, цены, остатки и связанные предложения. Читать Колонки, фильтры и поиск в каталоге Как настроить таблицу товаров/предложений и искать данные в каталоге. Читать Настройки сводного каталога Как управлять полями, группами полей, словарями значений, разделами и отображением каталога. Читать Настройки шаблона импорта в сводный каталог Идентификация элементов, типовые сценарии, защита импорта, очистка после загрузки и правила товаров, предложений и разделов. Читать Откат импорта в сводный каталог Когда использовать откат, какие данные возвращаются и что происходит с объектами, у которых есть другие источники. Читать Правила итогового остатка Как настроить источники остатков и правила формирования итогового количества. Читать Правила итоговой цены Как настроить группы цен, типы цен, приоритеты, фильтры, коррекцию и округление. Читать Пресеты импорта: бережный обмен, полный снимок и дозагрузка Как выбрать стратегию создания, обновления и удаления данных при импорте в каталог. Читать Разделы каталога Как загружать, создавать, обновлять и очищать разделы товаров. Читать Режимы импорта в сводный каталог Режим импорта определяет масштаб изменений: от аккуратной работы только с текущим источником до полной синхронизации сводного каталога с разделами, характеристиками, торговыми предложениями и очисткой пропавших данных. Читать Сводный каталог: первая загрузка и базовая настройка Как загрузить данные в сводный каталог Eofferix, настроить снапшот, назначить поля, создать характеристики и разложить цены и остатки по группам. Читать Сводный каталог и обычная выгрузка: в чем разница Практическое сравнение обычной выгрузки и сводного каталога: что выбирается на входе, где хранятся данные, когда нужен каталог и как из него делать экспорт. Читать Свойства сводного каталога: товары, предложения и разделы Как создавать и редактировать свойства товаров, предложений и разделов в сводном каталоге Eofferix, а также добавлять свойства прямо из снапшота. Читать Товары и торговые предложения Как различать товары и предложения в сводном каталоге. Читать Характеристики из источника в Сводном каталоге Как автоматически создавать свойства каталога из повторяющихся пар "название свойства" и "значение свойства" в XML или JSON. Читать

Запуски, история и архив профилей Где смотреть результаты запусков, восстанавливать профили и удалять их окончательно. Читать Планировщик задач Как читать единый список расписаний источников и профилей. Читать Расписание профиля Как запускать преобразование по cron и отличать его от расписания источника. Читать

FTP/SFTP-доставка результата из профиля Как отправить готовый результат профиля на FTP, FTPS или SFTP-сервер после обработки. Читать Внешняя выгрузка: куда отправлять результат и SMTP Как настроить отправку результата наружу: email, ссылка, FTP/SFTP, webhook и отправка письма с почты Eofferix или через SMTP пользователя. Читать Внешняя доставка результата Обзор каналов доставки: email, публичная ссылка, FTP/FTPS, SFTP, webhook, Яндекс Диск, Google Drive, Dropbox и Mail.ru. Читать Отправка результата по email и SMTP Как настроить получателя, тему письма, ссылку вместо вложения и отправку с собственной почты. Читать Хранение версий результата Как задавать число сохраненных результатов и удаление результата на сервисе. Читать

Дополнительные опции тарифа Шаблоны интерпретатора, одновременные запуски, хранилище и докупка кредитов. Читать Заказы и история оплаты Где смотреть созданные заказы, статус оплаты, сумму и действие по оплате. Читать Персональная база сводного каталога Когда нужна отдельная база каталога и что происходит при неоплате. Читать Персональный сервер для вычислений Когда подключать персональный сервер и чем он отличается от обычного тарифа. Читать Тарифы, кредиты и лимиты Как базовые тарифы влияют на кредиты, хранилище, шаблоны, запуски и каталог. Читать Что делать, если лимит хранилища превышен Лимит хранилища показывает, сколько места занимают исходники, результаты, изображения, документы и файлы сводного каталога. Читать

Support bundle для диагностики Когда скачивать support bundle и что он помогает проверить. Читать Источник не обновился по расписанию Как диагностировать сбой загрузки источника: расписание, доступ, пароль, структура и повторные попытки. Читать Как удалить старые результаты и освободить место Старые результаты часто занимают больше места, чем настройки профилей. Их можно удалить без удаления самого профиля. Читать Почему файл XLSX или CSV не проходит проверку Типовые причины ошибок XLSX/CSV: строка заголовков, лишние строки, объединенные ячейки, пустые колонки, разделители и изменение структуры. Читать Профиль завершился ошибкой Как разбирать ошибку запуска профиля и что проверить в первую очередь. Читать Раздел Файлы и контроль хранилища Как смотреть количество файлов, занятое место и группы storage. Читать

JSON-снапшот Как работать со структурой JSON: массивы, объекты, поля, выбор повторяющегося элемента и предпросмотр. Читать XML-снапшот Как читать дерево XML, выбирать узлы, настраивать правила и проверять предпросмотр результата. Читать Повторяющиеся значения из XML/JSON при конвертации в таблицу Как вывести массивы и повторяющиеся XML/JSON-узлы в CSV/XLSX без потери значений. Читать Табличный снапшот Как настроить XLSX/CSV: листы, строка заголовков, объединение листов, выбор колонок и предпросмотр. Читать

Вложенные XML и JSON элементы Как создавать родительские и дочерние элементы, массивы, группы и повторяющиеся блоки в результате. Читать Выбор формата результата Как выбрать XML, JSON, XLSX/CSV, маркетплейс, API-шаблон или запись в сводный каталог. Читать Картинки и файлы в результате Как выводить ссылки на изображения и файлы, обрабатывать несколько картинок, менять размер, формат и watermark. Читать Поля результата Как создавать поля результата, задавать название, порядок, обязательность, значения по умолчанию и источники данных. Читать

Импорт в UMI.CMS Как подключить UMI.CMS, выбрать идентификаторы, настроить правила импорта и запустить передачу товаров, предложений и разделов. Читать Характеристики из источника для UMI.CMS Как создавать и обновлять характеристики UMI.CMS из повторяющихся свойств источника. Читать