Настройка загрузки отчета из файла v2

1. Как открыть справочник

Обычные формы - Операции → Справочник → Маркетплейсы: Настройки загрузки отчетов.

Управляемые формы - ИТС: мБридж → Сервис → Маркетплейсы: Настройки загрузки отчетов.

2. Зачем нужна настройка

Отчёт маркетплейса - Excel-таблица. В колонках артикул, сумма, признак продажи или возврата и т.д. У разных маркетплейсов структура файла разная.

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

Без настройки файл не разбирается. С настройкой модуль читает Excel и формирует позиции (продажи, возвраты, невыкупы).

Колонки и строки - в Excel колонки обозначаются буквами (A, B, … K, … BE), строки - номерами. В настройке источник чаще всего указывается буквой колонки, например N → поле Количество.

3. Как открыть и проверить настройку

Шаг 1 - Открыть справочник (см. раздел 1).

Шаг 2 - Создать новую настройку или открыть существующую.

Шаг 3 - Заполнить шапку и вкладки в порядке: Листы → Секции → Поля → Фильтры.

Шаг 4 - Справа: Открыть образец - выбрать Excel-файл отчёта.

Шаг 5 - Тестовая загрузка - проверить результат. При необходимости скорректировать настройку и повторить.

Шаг 6 - Записать настройку.

На форме также доступны Добавить стандартные поля, Загрузить из JSON и Выгрузить в JSON.

4. Структура формы

• Шапка - наименование, маркетплейс, ключ слияния, порядок поиска номенклатуры.
• Вкладки - Листы, Секции, Фильтры, Поля.
• Правая панель - образец файла и проверка.

5. Шапка

Наименование - название настройки, например "Wildberries - Позаказный отчёт (слияние по Srid)".

Маркетплейс - Wildberries, OZON и т.д.

Поле ключа слияния - буква колонки Excel, по которой несколько строк одного заказа объединяются в одну позицию. Пример: BE. Указывается буква колонки, а не заголовок ("Srid"). Пустое значение - каждая строка файла даёт отдельную позицию.

Искать номенклатуру по - порядок поиска товара через запятую, сначала более надёжные ключи: например offer_id,lm_id,sku,Штрихкод,Артикул,Наименование. Наименование обычно ставят последним.

Порог похожести наименования - порог сравнения по наименованию. Обычно 0, если поиск по наименованию не основной.

6. Ключ слияния

В позаказных отчётах один заказ может быть разбит на несколько строк: продажа, логистика, возмещения. У этих строк общий идентификатор в одной колонке (у WB часто Srid в колонке BE).

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

• Одинаковое значение в колонке ключа → одна позиция.
• Разные значения → разные позиции.
• Пустая ячейка ключа → строка не объединяется с другими пустыми.

Если в файле уже "одна строка = одна позиция", поле ключа слияния оставляют пустым.

7. Вкладка "Листы"

Указывает, какие листы Excel участвуют в разборе.

Индекс листа - номер с нуля (первый лист = 0). На него ссылаются секции.

Имя листа - имя вкладки в Excel, например Лист1. Поиск сначала идёт по имени.

Тип данных - Продажи / Возвраты / Невыкупы. Основной тип задаётся на секции.

Типичный случай: одна строка - индекс 0, имя как во вкладке файла, тип Продажи.

8. Вкладка "Секции"

Секция задаёт диапазон строк на листе и тип данных (продажи или возвраты).

Код - короткий код секции, например PRD и RET. Используется в фильтрах и полях.

Лист - индекс с вкладки Листы (обычно 0).

Тип данных - Продажи, Возвраты или Невыкупы.

Множитель - коэффициент для числовых полей секции. Для продаж обычно 1, для возвратов часто -1.

Старт тип - способ определения начала данных:

• Фиксированная строка - в Старт строка указывают номер первой строки данных (не строки заголовков). Если заголовки в строке 1, а данные с 2 - указывают 2.
• По значению в колонке - поиск маркера в ячейке (например "РЕАЛИЗАЦИЯ") и смещение вниз до данных.

Стоп тип - условие окончания чтения:

• До конца - до конца листа;
• Пустая строка - остановка на пустой строке;
• По значению в колонке - остановка на строке вроде "Итого".

Типичная схема:

1. Секция PRD: старт строка 2, стоп "До конца", тип Продажи, множитель 1.
2. При возвратах в той же таблице - секция RET с теми же границами, тип Возвраты, множитель -1; разделение - фильтрами.

9. Вкладка "Поля"

Задаёт соответствие: колонка Excel (или выражение) → поле результата. Каждая строка таблицы - одно правило.

Секция - код секции (PRD, RET).

Поле - имя в результате. Можно выбрать стандартное или указать произвольное.

Тип источника:

• Колонка - значение из одной колонки Excel;
• Константа - фиксированное значение;
• Выражение - склейка или арифметика колонок, например [E]|[G]|[C] или [AB]+[BF]+[AC];
• Регулярка - извлечение фрагмента текста по шаблону.

Источник - для типа "Колонка" - буква колонки: N, P, K, BE.

Множитель - множитель только этого поля (обычно 1). Знак возврата предпочтительно задавать множителем секции.

Обязательное заполнение - при пустом значении или нуле строка файла отбрасывается целиком. При слиянии для Количество обычно не включают: иначе строки логистики с нулём не попадут в объединение.

Режим агрегации - используется при заполненном ключе слияния: как объединять значения поля у строк с одним ключом.

Стандартные имена полей

• товар: Наименование, sku, offer_id, lm_id, Артикул, Штрихкод, Размер;
• количество и цены: Количество, ЦенаПродажи, СуммаПродажи, ЦенаПередачи, СуммаПередачи, ЦенаРозничная;
• комиссия: СуммаВознаграждения, СуммаБонусов;
• затраты: Логистика, Хранение, Штрафы, ПлатнаяПриемка, ПрочиеЗатраты;
• прочее: Дата, ЗаказНомер, ПоставкаНомер, реквизиты СФ и контрагента.

Произвольное поле

Имя поля может быть любым - значение попадёт в результат под этим именем.

Пример: колонка Excel K → поле РасходыНаЭквайринг.

Секция - PRD

Поле - РасходыНаЭквайринг

Тип источника - Колонка

Источник - K

Множитель - 1

Режим агрегации - Сумма (если при слиянии значения нужно складывать)

После загрузки у позиции будет свойство РасходыНаЭквайринг со значением из колонки K.

Минимальный набор для старта: идентификаторы товара, Количество, суммы, при наличии - Дата.

10. Режим агрегации

Применяется, если заполнено Поле ключа слияния. Указывается в каждой строке вкладки Поля.

Сумма - сложение чисел (количество, суммы, логистика, произвольные денежные поля).

ПерваяНеПустая - первое непустое значение (наименование, коды, дата, цена за единицу).

Последняя - последнее непустое значение.

Максимум / Минимум - по числам.

НеСворачивать - значение первой строки группы без изменений.

Пусто - авто: известные суммовые поля → Сумма, остальное → ПерваяНеПустая. Для произвольных полей режим лучше указать явно.

• значения, которые нужно сложить → Сумма;
• текст и цена за единицу → ПерваяНеПустая.

11. Вкладка "Фильтры"

Определяет, какие строки Excel внутри секции включить в результат.

Секция - код секции.

Группа AND - номер группы. Условия с одним номером связаны через И, разные номера - через ИЛИ.

Колонка - буква колонки Excel.

Оператор - Равно, Не равно, Заполнено, Содержит, сравнение чисел и др.

Значение - операнд сравнения (для "Заполнено" можно не указывать).

Пример (колонка K - тип операции, BE - идентификатор заказа):

• PRD, группа 1: BE Заполнено и K Не равно "Возврат";
• RET, группа 1: BE Заполнено и K Равно "Возврат".

При слиянии не используют фильтр "количество заполнено": строки логистики с нулём отбрасываются до объединения.

12. Порядок настройки

Шаг 1 - В Excel найти строку заголовков и первую строку данных, определить буквы нужных колонок.

Шаг 2 - Создать настройку: наименование, маркетплейс, "Искать номенклатуру по".

Шаг 3 - Листы: индекс 0, имя вкладки.

Шаг 4 - Секции: код PRD, старт = первая строка данных, стоп = до конца, тип Продажи, множитель 1.

Шаг 5 - Поля: идентификаторы товара, количество, суммы; при необходимости произвольные поля.

Шаг 6 - При разнесённых строках заказа - указать ключ слияния (буква колонки) и режимы агрегации.

Шаг 7 - Фильтры: отбор нужных строк (продажа / возврат и т.п.).

Шаг 8 - Открыть образец → Тестовая загрузка.

Шаг 9 - Скорректировать при необходимости и Записать.

13. Пример: WB, слияние по Srid

Несколько строк с одним Srid (продажа + логистика + возмещения) должны дать одну позицию.

Поле ключа слияния - BE

Лист - индекс 0, имя Лист1

Секция PRD - старт строка 2, стоп "До конца", Продажи, множитель 1

Фильтры PRD - BE Заполнено и K Не равно "Возврат"

Секция RET - те же границы, Возвраты, множитель -1

Фильтры RET - BE Заполнено и K Равно "Возврат"

Поля - количество и суммы: Сумма; наименование и коды: ПерваяНеПустая

14. Частые ошибки

Ключ слияния = "Srid" - нужен буква колонки, например BE.

Старт строка = строка заголовков - в данные попадают названия колонок. Указывают первую строку данных.

Неверная буква колонки - сверить с образцом файла.

Фильтр "количество заполнено" при слиянии - отбрасывает логистику до объединения.

Нет режима агрегации у произвольного числового поля - для суммирования указать Сумма.

Обязательное заполнение на Количество при слиянии - строки с количеством 0 (например логистика) отбрасываются до объединения и не попадают в позицию.

Множитель -1 на секции и на поле - двойной минус. Знак обычно только на секции.

Наименование первым в поиске - выше риск ложного сопоставления. Сначала коды и штрихкод.

15. Краткая шпаргалка

Лист - какую вкладку Excel читать.

Секция - диапазон строк и тип данных (продажи / возвраты).

Фильтр - какие строки включить.

Поле - откуда взять значение для реквизита позиции (в т.ч. произвольное имя).

Поле ключа слияния - колонка для объединения строк одного заказа.

Режим агрегации - как объединять поле при слиянии.

Тестовая загрузка - проверка настройки на образце.

Функционал может отличаться в зависимости от конфигурации 1С, версии модуля и маркетплейса и доступен при наличии соответствующих прав и настроек.