Определение
Выгрузка и загрузка каталога — это процесс передачи данных о товарах между учётной системой продавца и торговой платформой Kaspi.kz в виде файлов или через API для создания и обновления карточек, цен и остатков.
Как работает процесс: форматы, этапы и сценарии
Процесс включает три основных этапа: подготовка исходного файла, передача на платформу и валидация результатов. Технически это реализуется четырьмя способами:
- Ручная загрузка через кабинет продавца Kaspi (Excel или CSV) — простой старт для малого ассортимента.
- Массовая выгрузка/импорт по расписанию через FTP/HTTP с CSV или XML в заранее заданном шаблоне.
- Интеграция по API — длительная настройка, даёт оперативную синхронизацию остатков и цен.
- Промежуточные интеграторы или ETL-инструменты (например, AWW) — автоматизация трансформации и валидации данных между 1C, складом и Kaspi.
Типичная структура файла для массовой загрузки включает поля: SKU, Наименование, Артикул, Цена, Остаток, Бренд, Штрихкод (EAN), Категория, Ссылка на изображение, Описание. Перед отправкой файл считают в кодировке UTF-8 или CP1251 в зависимости от требований кабинета продавца.
После загрузки платформа выполняет валидацию по набору правил: уникальность SKU, корректность категории, соответствие формата цены, доступность картинки по ссылке. Результат валидации приходит в виде отчёта с количеством принятых и отклонённых записей и описанием ошибок.
Зачем это нужно продавцу: конкретно и с примерами влияния на продажи
Работа с каталогом напрямую влияет на видимость и конверсию карточек товара. Практические выгоды:
- Синхронизация остатков предотвращает отмены заказов. Пример: продавец с 2 000 SKU вручную обновлял остатки раз в день и имел 3–5% отмен по нехватке. После автоматической выгрузки по API с интервалом 15 минут отмены упали в несколько раз.
- Быстрое обновление цен при акциях. Пример: при запуске акции продавец с 1 200 SKU массово изменил цену в файле и загрузил за 15 минут, тогда как ручные правки заняли бы 2 дня и привели бы к потерянной марже.
- Качество карточек: корректные атрибуты и хорошие изображения повышают CTR и конверсию. Продавец, который добавил 3 изображения и детализированные характеристики для 500 SKU, увидел рост конверсии на видимом участке поиска.
- Экономия работы: массовая загрузка экономит время сотрудников. Пример оценки: обновление 5 000 позиций вручную может занимать несколько рабочих дней, автоматизированная загрузка укладывается в часы.
Кроме этого, грамотная выгрузка нужна для fulfilment-операций (FBS/FBO), управления sku-матрицами и интеграции с бухгалтерией.
Примеры типичных ошибок и ситуаций на Kaspi.kz
Ниже реальные ситуации, с которыми сталкиваются продавцы в Казахстане, и способы их решения.
-
Ошибка кодировки и символов
Симптом: русские буквы и знаки препинания искажены после загрузки. Причина: несоответствие кодировки CSV. Решение: сохранять файл в UTF-8 или CP1251 согласно инструкции кабинета Kaspi; перед загрузкой проверить первые строки в текстовом редакторе.
-
Дублирующиеся SKU
Симптом: часть позиций отклоняется с ошибкой «дублирование». Причина: одна и та же торговая единица имеет несколько артикулов или пробелы в конце строки. Решение: нормализовать SKU, удалить лишние пробелы, использовать уникальное поле артикул. Перед загрузкой прогонять контроль уникальности.
-
Ошибки картинок
Симптом: изображения не подтягиваются или отклоняются. Причина: картинка недоступна по ссылке, неправильный формат или малая размерность. Решение: хостить картинки на HTTPS, проверять доступность по прямой ссылке и соответствие минимальным требованиям качества.
-
Неправильная категория
Симптом: карточка отклонена или размещена в неверном разделе. Причина: несоответствие значений поля «Категория» справочнику платформы. Решение: использовать справочник категорий Kaspi или ID категории из кабинета, при массовой миграции сопоставлять категории заранее.
-
Расхождения остатков
Симптом: продажи фиксируются, но остатки не уменьшаются корректно. Причина: выгрузка остатков идёт нерегулярно или не учитывает резерв. Решение: настроить частую синхронизацию (через API или плановые выгрузки каждые 15–60 минут) и учитывать резервы заказов.
Практические советы и чек-лист для корректной выгрузки и загрузки
Пошаговый чек-лист для подготовки и запуска массовой загрузки каталога, адаптированный под Kaspi.kz.
-
Подготовка мастер-каталога
Соберите единый файл-источник с полями: SKU, Наименование, Артикул, Цена, Остаток, Категория, Бренд, Штрихкод, Ссылка на изображение, Описание. Проведите очистку данных: удалите дубли, пробелы, невалидные символы.
-
Сопоставление атрибутов
Сделайте таблицу соответствий между полями вашего учёта и требуемыми полями Kaspi. Особенно важно правильно сопоставить категорию и единицы измерения.
-
Тестовая загрузка
Перед массовым запуском загрузите тестовый набор 10–50 позиций. Проверьте отчёт платформы и исправьте ошибки.
-
Планирование обновлений
Определите частоту обновлений: остатки каждые 15–60 минут, цены и описания по расписанию раз в день или при изменениях. Для больших каталогов используйте инкрементальные загрузки — только изменённые записи.
-
Логирование и резервная копия
Храните версии выгрузок не менее 30 дней и сохраняйте отчёты с ошибками. Это упрощает откат и анализ проблем.
-
Автоматизация и мониторинг
Используйте инструменты автоматизации для расписаний, трансформации полей и обработки ошибок. AWW может помочь с плановой выгрузкой, трансформацией форматов и обработкой отчётов об ошибках.
-
Регулярная сверка
Проводите ежедневную сверку оборотов и остатков между Kaspi и учётом. Для 1 000–5 000 SKU автоматизированные сверки позволяют быстро выявить расхождения и ошибки в загрузке.
Технические моменты и рекомендации по интеграции
Некоторые технические нюансы, которые помогут избежать сбоев:
- Формат CSV: проверяйте разделитель полей — запятая или точка с запятой в зависимости от локали. Пробелы и спецсимволы могут нарушать парсинг.
- Кодировка: предпочтительна UTF-8. Если используется CP1251, заранее прогоняйте тестовую загрузку.
- Изображения: обеспечьте прямые публичные ссылки к изображениям и следите за размером. Если платформа требует HTTPS, размещайте картинки на защищённом хостинге.
- API: при интеграции через API обрабатывайте rate limit и делайте повторные попытки при временных ошибках. Для массовой синхронизации используйте пачки по 100–500 записей, чтобы снизить риск таймаутов.
- Отчёты ошибок: автоматизируйте парсинг отчётов от Kaspi и формируйте задачи на исправление по категориям ошибок.
Краткий итог и практический совет
Выгрузка и загрузка каталога — это операционный процесс, который при правильной настройке сокращает ручной труд, уменьшает отмены заказов и повышает продажи. Начинайте с небольших тестов: загрузите 10–50 позиций, проверьте отчёты, затем масштабируйте. Если у вас большой ассортимент или несколько источников данных, внедрите автоматизацию и регулярные сверки; инструмент автоматизации, например AWW, заметно упрощает трансформацию и расписание выгрузок.
Практический совет: перед массовой загрузкой сделайте бэкап текущих карточек и выполните пилотную загрузку 1% ассортимента. Это позволит отловить 90% типичных ошибок до масштабного релиза.
Часто задаваемые вопросы
- Какую кодировку и формат файла использовать при массовой загрузке на Kaspi.kz?
- Используйте формат, который поддерживает кабинет продавца — обычно CSV (с запятой или точкой с запятой), Excel (.xlsx) или XML по шаблону платформы. По кодировке чаще требуется UTF-8, но в некоторых кабинетах допускается CP1251 — проверьте требования конкретного интерфейса перед выгрузкой. Неправильная кодировка ломает названия и описания, поэтому всегда тестируйте на небольшой выборке.
- Что делать при ошибках в отчёте валидации (например «некорректная категория» или «отсутствует EAN»)?
- Скачайте подробный отчёт и исправьте записи по строкам, указанным в файле ошибок; правьте исходный файл или маппинг в интеграторе и повторно загрузите только корректные строки. Если платформа приняла часть записей, синхронизируйте статусы и проверьте зависимости (например обязательные атрибуты по категории). Для массовых правок автоматизируйте исправления скриптом или через ETL-инструмент, чтобы избежать ручных ошибок.
- Как часто синхронизировать остатки и цены и какой метод лучше выбрать — FTP, API или ручная загрузка?
- Для небольшого ассортимента достаточно ручной или по расписанию FTP/HTTP обновления раз в сутки, но для динамичных запасов и цен необходима API-интеграция с частотой обновления в реальном времени или каждые несколько минут. API даёт меньшую задержку и меньше ошибок при конкуренции за товар, а FTP/CSV подходит для менее критичных товаров. Выбирайте метод в зависимости от объёма, скорости оборота и возможностей вашей учётной системы.
- Как правильно передавать изображения и что делать при ошибке «недоступна ссылка на изображение»?
- Передавайте прямые публичные ссылки на изображение по HTTPS, убедитесь, что URL возвращает корректный статус 200 и файл доступен без авторизации. Проверьте требования к формату и размеру изображений у Kaspi и при необходимости разместите файлы на вашем CDN или в сервисе хранения с постоянными ссылками. Если ссылка недоступна, загрузите изображение в кабинет продавца или исправьте путь и повторно проверьте валидацию.
- Как корректно сопоставить категории и обязательные атрибуты при массовой загрузке каталога?
- Используйте идентификаторы категорий из справочника Kaspi, а не только текстовые названия, и подготовьте маппинг между вашей номенклатурой и деревом категорий платформы. Для каждой категории заполните обязательные атрибуты (размер, цвет, страна-производитель и т.д.), иначе записи будут отклонены. При большом каталоге автоматизируйте маппинг в ETL-инструменте и протестируйте на выборке перед полной загрузкой.
