Обзор
Назначение дельта-фида
Дельта-фид даёт возможность обновлять данные о товарах: цены, остатки и другие атрибуты.
Формат и доступность фида
Технические требования к файлу
Фид должен быть доступен по ссылке в формате CSV.
Наименование региональных фидов
Схема именования файлов для регионов
Название каждого регионального фида должно соответствовать схеме: название города на латинице + city_id
примеры имён файлов
MSK_123 ← Москва, city_id = 123 SPB_456 ← Санкт-Петербург, city_id = 456
Содержимое фида
Какие товары включать в дельта-фид
В фиде должны присутствовать только товары, по которым произошли изменения.
Передача данных по всем товарам возможна, но это увеличит интервал между обновлениями фидов.
Количество
offer_id в дельта‑фиде не должно превышать 65 536 — иначе информация обновляться не будет.
Структура CSV и заголовки
Правила оформления файла
CSV‑файл с заголовками, разделитель — точка с запятой
;.
Наименования атрибутов должны быть идентичны тем, что указаны в YML‑фиде.
Регистр всех заголовков должен быть строго таким, как указано (включая
oldPrice, regionExternalId). Регистр названий атрибутов должен совпадать с YML для корректной идентификации.
Если у товара несколько значений атрибута, перечисляйте их через запятую (или иной установленный разделитель).
Основные заголовки
Описание всех полей CSV-файла
| Заголовок | Обязательность | Описание |
|---|---|---|
| id | обязателен | Значение offer_id из YML‑фида. |
| price | обязателен | Актуальная цена. Не может быть равна 0 или пустой — такая строка будет пропущена. Если товар недоступен, цену менять не нужно. |
| available | обязателен | Наличие товара: 1 — в наличии; отсутствие значения или любое иное — нет в наличии. |
| oldPrice | необязателен | Старая цена (если используется). |
| regionExternalId | необязателен | ID региона (при наличии регионов, но без региональных дельта‑фидов). |
| Названия атрибутов из фида | необязательны | Дополнительные атрибуты из YML (например, «Цвет», «Размер»). Если у атрибута несколько значений — перечисляйте через запятую (или иной установленный разделитель). |
Пример полной структуры
CSV-файл с заголовками и данными
Сырой CSV
csv
id;price;available;oldPrice;regionExternalId;Наличие на складе;Цвет 123456;1999;1;5999;MSK;Есть в наличии;Голубой,Зелёный 123456;1999;1;5999;SPB;Есть в наличии;Красный
Визуальное представление
| id | price | available | oldPrice | regionExternalId | Наличие на складе | Цвет |
|---|---|---|---|---|---|---|
| 123456 | 1999 | 1 | 5999 | MSK | Есть в наличии | Голубой,Зелёный |
| 123456 | 1999 | 1 | 5999 | SPB | Есть в наличии | Красный |
Важное предупреждение
Изменение порядка заголовков и разделителей
Если вы изменяете порядок заголовков (внешний ID, цена, доступность, ID внешнего региона) либо используемый разделитель заголовков или разрядов чисел — пожалуйста, заранее уведомляйте сопровождающего менеджера или службу поддержки, чтобы мы могли корректно обработать данные и избежать ошибок в работе сервиса.