Загрузка товаров из файла

Как завести сотни карточек из файла клиента или прямо из кабинета Wildberries / Ozon по API

Справочник на двести позиций руками набивают неделю. При этом у клиента такой список обычно уже есть — выгрузка из кабинета маркетплейса или таблица из его складской программы. Кнопка «Импорт» в разделе «Товары» → «Из файла» берёт эту таблицу как есть. Второй пункт, «По API маркетплейса», берёт карточки прямо из кабинета Wildberries или Ozon — см. раздел «Загрузка по API маркетплейса» ниже.

Принимаются Excel (.xlsx) и CSV. Старый .xls не читается — пересохраните в Excel как «Книга Excel (.xlsx)». За один раз до 5000 строк.

Как это выглядит

Шаг первый. Выбираете клиента-владельца, единицу габаритов и файл.

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

Рядом переключатели:

Самый надёжный ключ — код товара (уникальный, см. «Клиенты и товары»). Если в файле есть колонка с кодом — сопоставьте её, и одноимённые товары с разными кодами не перепутаются. Если колонки кода нет, новым товарам код присвоится автоматически.

Обязателен один столбец — название. Остальные можно оставить «— не загружать —».

Сначала предпросмотр, потом запись

Кнопка «Показать результат» ничего не пишет в базу — она прогоняет импорт вхолостую и показывает план: сколько создадим, сколько обновим, сколько пропустим и почему. У обновляемых строк видно, какие именно поля изменятся.

Только после этого разблокируется «Импортировать». Если вы поменяли сопоставление или режим — предпросмотр гаснет, его нужно показать заново.

Каждая строка файла — отдельная карточка

Одна строка — один товар. Если у модификаций (размер, цвет) в файле повторяется один и тот же артикул — а в выгрузках МойСклада это обычное дело, — все они станут разными карточками, а не сольются в одну. Штрих-коды из одной ячейки (записанные через запятую или точку с запятой) при этом попадают в эту одну карточку. Чтобы модификации не перепутались при повторной загрузке, дайте им разные коды товара — сопоставьте колонку «Код» (в выгрузке МойСклада это внутренний код позиции, он у каждой модификации свой).

Один и тот же штрих-код в двух строках файла — вторая строка отклоняется: код на складе принадлежит ровно одному товару.

Повторная загрузка не задваивает

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

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

Срок годности, «Честный Знак», состав

В выборе над столбцами есть все поля карточки товара: «Срок годности», «Срок годности, дней», «Честный Знак», «Состав» и другие — новые поля карточки появляются здесь сами. Если столбец в файле называется так же, как в выгрузке «Экспорт в Excel», он сопоставится сам: выгрузили, поправили, загрузили обратно.

• Галочки («Срок годности», «Честный Знак») — «да» или «нет» (подойдут и 1/0, +/−). Другое слово — строка не пройдёт, в отчёте будет, что не понято.
• Числа — как обычно, дробная часть у дней округляется.
• Срок годности без дней не бывает, как и в карточке: «да» при пустых или нулевых днях не пройдёт. Если в файле только галочка, а дни уже есть в карточке, — пройдёт.
• В предпросмотре эти поля показаны «было → стало», как и остальные.

Что не пройдёт

Плохая строка не отменяет весь файл: остальное загрузится, а по ней вы получите отчёт — номер строки (как в Excel, вместе с шапкой), товар и причина.

Штрих-код здесь строже всего, и намеренно: сканер должен попадать ровно в один товар. Если один код окажется у двух карточек, кладовщик разложит чужое.

Выгрузка из кабинета маркетплейса

Такие файлы начинаются не с заголовков: сверху стоит название отчёта, дата или фильтры. Система это понимает — ищет строку заголовков сама и пишет на втором шаге, сколько строк над ней пропущено. Проверьте это число: если оно неверное, значит колонки поедут на строку, и загружать нельзя.

Из выгрузки Озона («Отчёт по товарам») подхватываются Артикул, Название товара и Штрихкод. Именно «Артикул» — это ваш артикул продавца; стоящий рядом «SKU» — внутренний номер площадки, для нас он бесполезен, и система его не берёт.

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

Загрузить можно и в два захода: сначала выгрузку площадки (названия, артикулы, коды), потом свой файл с габаритами — по тем же артикулам он обновит карточки, не задваивая их.

Подводные камни файлов

Excel портит длинные штрих-коды. Открыв CSV двойным щелчком, Excel превращает 4600900000011 в 4,6009E+12. Такой код система не примет — она распознаёт эту запись и пропускает её. Чтобы не потерять коды, задайте колонке текстовый формат до ввода или загружайте .xlsx, где формат хранится в самом файле.

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

Несколько штрих-кодов у товара пишутся в одну клетку через запятую или точку с запятой. Первый станет основным — он печатается на стикере.

Загрузка по API маркетплейса

Кнопка «Импорт» → «По API маркетплейса». Нужен ключ API клиента (карточка клиента → «Ключи API»); у ключа Wildberries — доступ к разделу «Контент», у ключа Ozon — к товарам.

1. Выберите площадку — Wildberries или Ozon, клиента и его ключ, нажмите «Загрузить товары». Каталог приходит таблицей: артикулы, наименование, штрихкоды, габариты (в сантиметрах), вес (в килограммах) и все характеристики площадки — каждая своим столбцом (состав, цвет, страна и т. п.). У Wildberries строка — это размер карточки: у каждого размера свои штрихкоды, и на складе это разные товары.
2. Сопоставлять: поле площадки = поле 2SKLAD — по чему искать уже заведённый товар. По умолчанию у Wildberries — «Баркод = Штрих-код», у Ozon — «Артикул = Артикул». Можно выбрать любое поле, в том числе доп. поле товара (например, «SKU Ozon» площадки = доп. поле «SKU Ozon» в 2SKLAD).
3. Над каждым столбцом выберите, в какое поле карточки 2SKLAD записать значение, или «— не загружать —». Наименование, артикул, штрихкод, габариты, вес и состав подставляются сами.
4. Отметьте, что делать: «Обновить найденные» и/или «Создать отсутствующие».
5. «Показать «было → стало»» — по каждой строке видно, что будет создано, какие поля и как поменяются у найденных, что будет пропущено и почему. Ничего ещё не записано.
6. Введите слово ПРАВКА (можно в английской раскладке) и нажмите «Записать».

Большой каталог показывается порциями: под таблицей — «Показано N из M» и кнопка «Загрузить ещё» (или «Показать все»); так же — в «было → стало». Длинные значения (например, описание) в таблице обрезаны до двух строк — наведите мышь, и подсказка покажет текст целиком. Окно импорта не закрывается случайным щелчком мимо него — только кнопкой «Закрыть».

Пустое значение на площадке поле в 2SKLAD не стирает. Повторная загрузка того же каталога ничего не задваивает — показывает «без изменений». Загрузка попадает в журнал событий.

Чего загрузка не делает

Она меняет только справочник. Остатки не появятся: товар нужно принять операцией «Приёмка». Это общее правило системы — остаток меняется только операцией, чтобы в журнале была видна причина каждой единицы на складе.