Загрузка остатков товаров с помощью XML-фида
Общая информация
XML-фид предназначен для автоматической загрузки информации об остатках товаров с ваших складов (торговых точек) на сайт. После активации данного способа загрузки система каждые 60 минут будет обращаться по указанному вами URL и обновлять информацию об остатках товаров.
Структура XML-файла
<?xml version='1.0' encoding='utf-8'?>
<stocks>
<stock>
<sku>LD 47.300.15</sku>
<pointId>А001</pointId>
<quantity>300</quantity>
<price>298.90</price>
<name>Кран шаровой латунный LD Pride 47.15.В-В.Б Ду 15 Ру 40 бабочка</name>
</stock>
<stock>
<sku>11110509402MULD000000000</sku>
<pointId>А002</pointId>
<quantity>25</quantity>
<price>3000.14</price>
<name>Кран шаровый LD КШЦФ из стали 20 Ду50 Ру4,0МПа</name>
</stock>
</stocks>Описание элементов XML-файла
| Поле | Описание | Обязательное |
|---|---|---|
| <stocks> | Корневой элемент, содержащий список всех остатков товаров. | Да |
| <stock> | Элемент, содержащий информацию об отдельном товаре. | Да |
| <sku> | Уникальный идентификатор товара (артикул LD). | Да |
| <pointId> | Идентификатор торговой точки (склада). | Да |
| <quantity> | Количество товара. | Да |
| <price> | Ваша цена на товар (должна быть больше или равна РРЦ). | Да |
| <name> | Наименование товара. | Нет |
Порядок загрузки XML-фида
- Перейдите в раздел «Мои остатки товаров» в личном кабинете.
- Активируйте способ загрузки «XML-фид». API способ будет деактивирован автоматически.
- Вставьте ссылку на XML-фид в соответствующее поле.
-
Нажмите кнопку «Обновить остатки».
Обратите внимание: после нажатия на кнопку задача по обновлению остатков будет поставлена в очередь на обработку. Обработка начнётся автоматически, как только очередь дойдёт до вашей задачи. Мгновенного обновления не происходит — скорость обновления зависит от текущей нагрузки на систему и количества ожидающих задач.
Частота загрузки
Сайт автоматически запрашивает XML-файл по указанному URL каждые 60 минут. Вы можете запустить обновление вручную, не дожидаясь расписания, с помощью кнопки «Обновить остатки».
Очистка остатков по таймеру
Остатки очищаются автоматически, если обновления не было в течение 2-х суток. Пользователь предварительно получает уведомление.
Обработка ошибок
В процессе загрузки производится валидация XML-файла. Ошибки записываются в лог с детальным описанием.
История обновлений
В разделе «История обновлений» отображаются статусы загрузки и детализированный лог ошибок.
Дополнительная информация
- При загрузке остатков предыдущие данные перезаписываются.
- Без наличия торговых точек функционал недоступен.
Список возможных ошибок
| Описание ошибки | Что делать? |
|---|---|
| Товар с указанным артикулом не найден | Проверьте правильность артикула и наличие товара в системе |
| Указанная точка продаж не найдена | Убедитесь, что выбранная точка продаж существует |
| Количество товара в точке продаж не указано или равно нулю | Заполните поле количества товара |
| Количество товара отрицательное | Введите положительное значение количества |
| Цена товара не указана или равна нулю | Заполните поле цены, убедившись, что значение больше нуля |
| Загружен поврежденный или пустой файл. Проверьте или заполните файл-шаблон и попробуйте загрузить его снова | Проверьте файл на соответствие шаблону и заполните его корректно |
| Файл не найден по указанному URL | Проверьте правильность URL и наличие файла |
| Доступ к файлу запрещён | Убедитесь, что у вас есть права доступа, или свяжитесь с вашим менеджером или отправьте обращение через форму обратной связи |
| Непредвиденная ошибка | Повторите попытку загрузки или свяжитесь с вашим менеджером или отправьте обращение через форму обратной связи |
| Превышено время ожидания при обработке файла | Попробуйте повторить загрузку файла |
| Структура файла некорректна или не соответствует ожидаемому формату | Сравните файл с шаблоном и исправьте структуру |
| pointId имеет неверный формат (ожидается формат вида A001) | Исправьте формат идентификатора, следуя примеру (например, A001) |
| Не заполнена обязательная колонка A (ID точки продаж) | Заполните идентификатор точки продаж согласно структуре файла XML |
| Не заполнена обязательная колонка B (Артикул) | Укажите артикул товара в обязательном поле |
| Цена указана неверно | Введите корректное числовое значение для цены |
| Количество указано неверно (не является числом) | Введите корректное числовое значение для количества |
| Указанная цена ниже РРЦ | Проверьте, чтобы цена не была ниже минимально допустимой |
| Количество должно быть строго больше 0 | Укажите положительное количество, больше 0 |
