Формат файла для загрузки лотов
Как устроен файл, которым продавец выгружает и загружает свои лоты: структура книги, правила заполнения ячеек и допустимые значения колонок.
Как этим пользоваться
Основной сценарий — обновление своих лотов:
- В кабинете продавца → Мои лоты → Экспорт. Выгрузится файл со всеми лотами; в первой колонке — ID лота.
- Поправьте нужные значения в Excel: цену, наличие, статус, описание.
- Импорт → выберите тот же файл. Изменения применятся к лотам по ID — перепутать карточки невозможно.
Второй сценарий — перенос лотов с другой площадки. Автоматической выгрузки с «Мешка» и других площадок нет: скачайте свои лоты у них, приведите файл к структуре ниже (проще всего — взять наш шаблон по ссылке в окне импорта) и загрузите. Строки без ID создадут новые лоты.
Загрузка не удаляет лоты
Файл может создавать и обновлять лоты, но не удаляет их. Лот, которого нет в файле, останется как был.
Структура книги
Файл — книга Excel из трёх листов:
| Лист | Что внутри |
|---|---|
| Товары | Данные. Первая строка — заголовки, её удалять нельзя |
| Справочники | Допустимые значения для колонок-справочников |
| Инструкция | Те же правила, что и на этой странице |
Принимаются .xlsx, .xls и .csv. Ограничения: до 10 МБ и до 5000 строк за раз, одновременно обрабатывается одна загрузка.
Правила заполнения
| Правило | Что означает |
|---|---|
Колонка id пустая | Будет создан новый лот |
Колонка id заполнена | Обновится существующий лот |
| Ячейка пустая | Значение не меняется (при обновлении) |
В ячейке - | Поле очищается |
| Чужой ID | Строка отклоняется, чужой лот не затрагивается |
| Колонка отсутствует | Поле не меняется — можно оставить в файле только нужные колонки |
Заголовки можно писать латиницей (price) или русской подписью (Цена, ₽), регистр не важен.
Повторная загрузка того же файла
Если в строке нет ID, но заполнены source и source_id, лот ищется по этой паре. Так повторная загрузка выгрузки с другой площадки не создаёт дубли.
Колонки
Обязательные при создании лота
| Колонка | Название | Тип | Пример |
|---|---|---|---|
title | Название | текст, до 200 символов | Pink Floyd — The Wall |
price | Цена, ₽ | число | 2500 или 1 500,50 |
stock_quantity | Наличие, шт | целое | 1 |
category | Категория | справочник | music |
condition | Состояние | справочник | used |
При создании лот попадает в черновики — опубликовать его можно колонкой status или из карточки.
Состояние и грейды
| Колонка | Название | Значения |
|---|---|---|
media_grade | Грейд носителя | M, NM, VG+, VG, G+, G, F, P |
sleeve_grade | Грейд обложки | те же + Generic |
device_grade | Состояние техники | ok, used, repair (только Hi-Fi) |
color | Цвет пластинки | black, colored, special |
Грейды носителя и обложки обязательны, когда состояние — used. Для обложки есть отдельное значение Generic — типовой конверт без оригинальной печати.
Данные релиза
Заполняются вручную и работают в фильтрах каталога:
artistrelease_formatrelease_labelrelease_catnorelease_countryrelease_yearrelease_genrerelease_stylediscogs_release_id — необязателен. Если указать, метаданные подтянутся из дискографии.
Остальные колонки
| Колонка | Название | Примечание |
|---|---|---|
status | Статус | active, inactive, draft |
subcategory | Подкатегория | Название из справочника |
description | Описание | |
weight | Вес, г | Влияет на расчёт доставки |
location | Местоположение | |
pickup_point | Индекс ПВЗ отправки | Почтовый индекс вашего пункта отправки |
shipping_cost | Стоимость доставки, ₽ | |
can_trade | Торг уместен | да / нет |
brand | Бренд | Для Hi-Fi; новый бренд заводится автоматически |
common_properties | Характеристики | |
youtube_link | Ссылка YouTube | |
source | Источник | Для переноса с другой площадки |
source_id | ID в источнике | Вместе с «Источник» защищает от дублей |
Только для чтения
Выгружаются для справки, при загрузке игнорируются:
idslugupdated_atphotosФотографии через файл не загружаются
В выгрузке колонка photos содержит ссылки на уже загруженные снимки. Добавить фото можно только в карточке лота.
Справочники
Категория (category): music — Музыка, hifi — Hi-Fi аппаратура
Состояние (condition): new — Новый, used — Б/У, collectible — Коллекционный
Статус (status): active — В продаже, inactive — Снят с продажи, draft — Черновик
Статусы «Продан» и «Удалён» ставит система. В выгрузке они встречаются — это нормально, при загрузке такие строки просто не меняют статус.
Цвет (color): black — Чёрный, colored — Цветной, special — Спецэффекты
Грейды — шкала Discogs: M (Mint), NM (Near Mint), VG+ (Very Good Plus), VG (Very Good), G+ (Good Plus), G (Good), F (Fair), P (Poor).
Что делать с ошибками
Плохие строки не отменяют весь файл: корректные применяются, а по остальным формируется отчёт. В окне импорта появится «Скачать отчёт об ошибках» — в нём указаны номер строки, колонка, значение и причина.
| Сообщение | Что делать |
|---|---|
| Лот с таким ID не найден среди ваших | Проверьте ID — он должен быть из вашей выгрузки |
| «Цена»: не похоже на число | Уберите текст и валюту, оставьте только число |
| Для состояния «used» нужен грейд носителя | Заполните media_grade |
| Для состояния «used» нужен грейд обложки | Заполните sleeve_grade |
| «Категория»: допустимо только music или hifi | Впишите код из справочника |
| «Индекс ПВЗ отправки»: среди ваших пунктов такого индекса нет | Сверьтесь со списком своих пунктов отправки |
Сначала проверьте файл
В окне загрузки есть галочка «Только проверить файл, ничего не менять». Она прогоняет файл целиком и показывает все ошибки, не трогая лоты.
Остались вопросы?
Напишите в службу поддержки или загляните в FAQ.