Товарный фид и API

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

Для передачи таких остатков в Veloseller предусмотрено два способа: товарный фид и API-источник.

Товарный фид

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

Veloseller поддерживает YML, Google Merchant и произвольный XML. При загрузке сервис автоматически определяет структуру и доступные поля товаров.

Для подключения потребуется публичная ссылка на фид. Она должна открываться без авторизации. Закрытые ссылки и локальные адреса использовать нельзя.

После подключения Veloseller будет самостоятельно получать данные из фида и обновлять склад по расписанию.

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

API-источник

API-источник используется, если данные необходимо передавать непосредственно из вашей системы в Veloseller.

В отличие от товарного фида, Veloseller не запрашивает данные самостоятельно. Ваша система отправляет актуальные остатки через API. Этот способ подходит для собственных сайтов, учётных систем и других решений, для которых требуется индивидуальная интеграция.

При создании склада Veloseller выдаёт токен доступа. Токен отображается только один раз, поэтому его необходимо сохранить сразу после создания. Если токен утрачен, восстановить его нельзя — потребуется выпустить новый.

На странице склада доступен пример запроса и ссылка на полную документацию API.

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

Какие данные нужно передавать

Основные данные о товаре:

• артикул;
• остаток;
• название;
• цена.

Артикул используется для идентификации товара между последовательными загрузками. Поэтому для одного и того же товара рекомендуется сохранять постоянный артикул.

Если артикул изменить, Veloseller будет воспринимать позицию как новый товар. История предыдущего артикула не будет автоматически перенесена на новую позицию.

Цена необходима для расчёта денежных показателей. Если цена отсутствует, Veloseller сможет анализировать изменение остатков, скорость продаж и покрытие запасами, но денежные показатели для такого товара будут недоступны или рассчитаны не полностью.

Как формируются показатели

Veloseller сохраняет последовательные состояния склада и сравнивает изменение остатков между ними.

Уменьшение остатка используется для определения продаж, а увеличение остатка учитывается как поступление товара. На основании накопленной истории рассчитываются скорость продаж, покрытие запасами и другие показатели.

Скорость продаж определяется по продажам за период и количеству дней, когда товар был доступен для продажи.

Для расчёта используется минимальное окно в 7 дней. Это позволяет избежать завышенной оценки скорости продаж для товаров, которые находились в наличии только несколько дней и быстро закончились.

Например, если товар поступил на склад и был полностью продан за три дня, его скорость не рассчитывается простым делением продаж на три дня. Для оценки применяется минимальный период в семь дней.

Почему важна регулярность обновления

Для корректного анализа важно передавать данные регулярно.

При ежедневном обновлении Veloseller получает последовательную историю изменения остатков и может точнее определить происходившие изменения.

Если данные передаются, например, один раз в неделю, сервис видит только состояние склада в начале и конце этого периода. Определить точный день изменения остатка в таком случае невозможно.

Veloseller не восстанавливает отсутствующие данные предположениями. Если информации за определённые дни недостаточно, такие периоды учитываются как дни без данных.

Поэтому для товарного фида и API-источника рекомендуется обеспечивать стабильное ежедневное обновление данных.