VkusVill_KZ-Landings

Стандарт Excel-файла для генератора лендингов

Дата создания: 2026-01-27
Базовый файл: 2025 12 26 Остаток (цены).xlsx
Используется для: Генерация лендингов типа “В Наличии” и “Обычный”

---

📋 Обязательные колонки

Структура файла (13 колонок)

Столбец	Индекс	Название колонки	Обязательность	Описание	Использование
A	0	Артикул	✅ ОБЯЗАТЕЛЬНО	Уникальный ID товара	ID товара в лендинге
B	1	Категория	✅ ОБЯЗАТЕЛЬНО	Категория товара	Группировка товаров на лендинге
C	2	Подкатегория	⚪ Опционально	Подкатегория товара	Не используется в текущей версии
D	3	Наименование	✅ ОБЯЗАТЕЛЬНО	Название товара	Отображается в карточке товара
E	4	Квант	⚪ Опционально	Количество единиц в упаковке	Используется для квантовой логики корзины
F	5	Штрихкод	⚪ Опционально	Штрихкод товара	Не используется в текущей версии
G	6	Срок годности (cутки)	⚪ Опционально	Срок годности в сутках	Отображается в деталях товара
H	7	Вес (гр/мл)	⚪ Опционально	Вес или объем товара	Отображается в деталях товара
I	8	Цена Партнеру	⚪ Опционально	Цена для партнера	Основная цена для отображения
J	9	Рекомендуемая Розничная Цена	⚪ Опционально	Рекомендуемая розничная цена	Не используется в текущей версии
K	10	Ссылка на фото	⚪ Опционально	URL изображения товара	Отображается в карточке товара
L	11	Ссылка на фото.1	⚪ Опционально	Дополнительная ссылка на фото	Не используется (обычно содержит “Ссылка на фото”)
M	12	Остаток	⚪ Опционально (только для типа “В Наличии”)	Количество товара на складе	Обязательно для лендинга “В Наличии”

---

🎯 Типы лендингов и требования

Лендинг “В Наличии”

Обязательные колонки:

• ✅ Артикул (A)
• ✅ Категория (B)
• ✅ Наименование (D)
• ✅ Остаток (M) - критично для типа “В Наличии”

Опциональные, но рекомендуемые:

• Квант (E) - для квантовой логики корзины
• Цена Партнеру (I) - для отображения цены
• Срок годности (cутки) (G) - для деталей товара
• Вес (гр/мл) (H) - для деталей товара
• Ссылка на фото (K) - для изображения товара

Лендинг “Обычный” (под заказ)

Обязательные колонки:

• ✅ Артикул (A)
• ✅ Категория (B)
• ✅ Наименование (D)

Опциональные, но рекомендуемые:

• Квант (E)
• Цена Партнеру (I)
• Срок годности (cутки) (G)
• Вес (гр/мл) (H)
• Ссылка на фото (K)

НЕ используется:

• ❌ Остаток (M) - для типа “Обычный” остаток не нужен

---

📝 Особенности обработки

Название колонки с наименованием

Генератор ищет колонку с названием товара по следующим вариантам (в порядке приоритета):

1. Наименование товара
2. Наименование
3. Название

Цена

Генератор использует колонку Цена Партнеру (столбец I, индекс 8) как основную цену.

Обработка:

• Цена может быть в формате с запятой: 650,00 → преобразуется в 650
• Пустые значения → 0 (отображается как “Цена по запросу”)

Ссылка на фото

Генератор автоматически определяет колонку со ссылками на фото:

• Ищет колонку, содержащую http в >30% значений
• Предпочтение отдается колонке Ссылка на фото (K)
• Игнорирует колонку Ссылка на фото.1 (L), если она содержит только текст “Ссылка на фото”

Остаток (для типа “В Наличии”)

• Столбец: M (индекс 12)
• Название: Остаток
• Формат: целое число
• Пустые значения → None (товар без остатка не показывается как “в наличии”)

Квант

• Может быть числом: 6 или 6.0
• Может быть строкой: "6 шт", "Квант: 6"
• Генератор автоматически извлекает число из строки

---

⚠️ Валидация файла

Генератор автоматически проверяет соответствие файла стандарту:

1. Проверка обязательных колонок - наличие Артикул, Категория, Наименование
2. Проверка типа лендинга - для типа “В Наличии” проверяется наличие колонки Остаток
3. Предупреждения - если файл не соответствует стандарту, генератор сообщает о различиях

Примеры сообщений об ошибках

❌ Не найдена колонка с наименованием товара
   Ожидается: Наименование товара, Наименование, Название

⚠️  Тип лендинга 'в-наличии', но остатки не найдены в данных!
   Ожидается колонка: Остаток (столбец M)

⚠️  Файл нестандартный. Различия:
   - Не найдена колонка 'Цена Партнеру' (ожидается столбец I)
   - Не найдена колонка 'Остаток' (ожидается столбец M для типа "В Наличии")

---

🔄 Совместимость

Генератор поддерживает следующие варианты названий колонок:

Стандарт	Альтернативные варианты
Наименование	Наименование товара, Название
Цена Партнеру	Стоимость товара в закупке, с НДС (ищется по индексу 7 или 8)
Срок годности (cутки)	Срок годности (сутки), Срок годности
Вес (гр/мл)	Вес, гр (Объём, мл), Вес
Ссылка на фото	Автоматически определяется по содержанию URL

---

📊 Пример корректного файла

Артикул | Категория | Подкатегория | Наименование | Квант | Штрихкод | Срок годности (cутки) | Вес (гр/мл) | Цена Партнеру | Рекомендуемая Розничная Цена | Ссылка на фото | Ссылка на фото.1 | Остаток
39018   | Нон-Фуд   | Спорт. питание | L-карнитин... | 9.0   | 2100100220495 | 720 | 225 | 650,00 | 900 | https://img.vkusvill.ru/... | Ссылка на фото | 342

---

🚀 Рекомендации по использованию

1. Для лендинга “В Наличии”:
   • Обязательно заполните колонку Остаток (M)
   • Убедитесь, что цены заполнены в колонке Цена Партнеру (I)
2. Для лендинга “Под Заказ”:
   • Колонка Остаток (M) не нужна (может быть пустой или отсутствовать)
3. Оптимизация:
   • Заполняйте Ссылка на фото для лучшего отображения товаров
   • Указывайте Квант для правильной работы квантовой логики корзины

---

Последнее обновление: 2026-01-27
Версия стандарта: 1.0