API

Обновление прайс-листов по API

Мгновенная синхронизация

Обновление характеристик товара
на основе данных прайс-листа

Оперативное добавление товарных позиций

Новые товары в прайс-лист будут автоматически добавлены на сайт

Удаление товара в реальном времени

API мгновенно удалит товар на сайте исходя из данных прайс-листа

Отправить заявку

Если вы хотите обновить прайс-лист целиком, следует воспользоваться этой инструкцией.

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

Преимущества обновления по API

При продаже товара продавцу нет необходимости удалять товар в прайсе и заливать его заново на обновление, прогоняя весь прайс;
Не нужно обновлять весь прайс целиком, достаточно отправить только товары, которые нужно: добавить, удалить или модифицировать;
Обновление онлайн любое количество раз без ограничений;
Всегда актуальная информация на сайте.

Описание API

Endpoint:

Content-Type: multipart/form-data

Обязательные параметры запроса:

Параметр	Значение
packetId	id прайс-листа, в котором нужно обновить товар. Значение вида 55359 хранится в ссылке на прайс-лист
auth	Должен вычисляться как hash('sha512', X), где X - строка с ключом. Ключ уникален на кабинет, предоставляется по запросу. Чтобы получить auth, необходимо рассчитать хэш по алгоритму sha512 от строки с ключом. Расчет можно выполнить с помощью онлайн-сервиса;
data	Файл или бинарный контент, данные товаров в том же формате, в котором был загружен изменяемый прайс-лист. Размер данных, переданных в этом параметре, не должен превышать 5 МБ.

Ответ при успешной отправке запроса: 200 ОК.

Требования к данным:

Файл с изменениями, имеет такой же формат, как и исходный загруженный прайс

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

Допустимые форматы: XLS, CSV, XML

При смене форматов с XLS на CSV, обновление пройдет успешно.

В минимальном варианте XML-прайс содержит информацию о наименовании, описании, количестве и цене товара

Инструкция по составлению XML-прайса

Указана колонка, отвечающая за количество

Если товар нужно удалить, в колонке отправить значение "0".

Пример в виде html-формы:

Описание ошибок

Ошибка	Описание	Возможное решение
ERROR_REASON_PACKET_NOT_FOUND	Выполнены не все настройки прайс-листа	Обратитесь к менеджеру сайта для подключения дополнительных настроек
ERROR_REASON_AUTH_FAILED	Неверный хэш	Проверить расчет хэша (auth). Строку auth необходимо пропустить через алгоритм хэширования sha512
ERROR_REASON_EMPTY_REQUEST	Отсутствует обязательный параметр data или auth	Проверить наличие и корректность параметров data или auth

Обновление прайс-листа

Несмотря на то, что часть товаров автоматически обновляется через API, прайс-лист устаревает со временем. Потому его необходимо обновлять полностью раз в 14 дней (инструкция).

Отправить заявку

Полезна ли статья?