Автоматическое обновление цен и остатков на Enex
Зачем настраивать API?
Подключить API очень важно, потому что это как «автоматический помощник» для вашего каталога на маркетплейсе Enex. Вместо того, чтобы вручную обновлять цены и указывать, сколько товара осталось, API делает это за вас автоматически.
Когда цены и остатки обновляются сразу и без ошибок, ваши товары всегда показываются правильно: покупатели видят какие товары есть в наличии, а какие придется подождать; а также покупатели уверены в корректности цен. Это помогает не потерять клиентов, потому что никто не хочет заказывать то, чего нет или сталкиваться с возвратами.
Автоматическое обновление через API ускоряет и упрощает работу: вы экономите время и силы, и ваши продажи становятся стабильнее. Если информация об остатках и ценах всегда актуальна, это повышает доверие клиентов и улучшает репутацию вашего бренда на платформе, что тоже привлекает больше покупателей.
В итоге, API помогает продавать больше и работать эффективнее, избегая потери заказов и ошибок из-за устаревших данных. Это как надежный помощник, который всегда держит ваш ассортимент в порядке и помогает зарабатывать больше.
Процесс настройки API
Для обновления информации о ценах и наличии товаров на платформе реализован соответсвующий функционал API, которым вы можете воспользоваться. В автоматическом режиме с установленной периодичностью вы сможете отправлять свои артикулы, актуальные цены и складские остатки.
-
Для начала получите ключ доступа (API Token). Его можно создать в Вашем Личном кабинете на сайте https://enex.market/account/api/ (авторизуйтесь под своим логином, чтобы посмотреть информацию).
-
Вся информация по использованию API, а также примеры запросов в формате JSON вы найдете в документации по ссылке https://enex.market/api/v1/schema.
-
Для обновления отправляйте данные через curl-запросы, обязательно указывая Ваш API Token в заголовках запроса в поле Authorization.
-
Формат запросов и структура данных подробно описаны в документации, чтобы упростить интеграцию и минимизировать ошибки.
Частые вопросы
Общие вопросы
- Не могу войти в Личный кабинет для генерации ключа доступа к API. Где могу найти свой логин и пароль?
При регистрации вы получали автоматическое письмо со всеми учётными данными. Если письмо потеряно, то воспользуйтесь формой сброса пароля или обратитесь к своему менеджеру.
- Могу я передавать цены и остатки до создания своего каталога на сайте?
Нет, сначала нужно заполнить шаблон на создание каталога на сайте (самостоятельно или в рамках услуги продвижения). После этого возможно обновление данных как через файл, так и с помощью API.
- Что делать, если у нас нет разработчика и есть только прайс-лист в xlsx?
Вы можете привлечь разработчика на аутсорсинге или веб-студию подрядчика - настройка передачи данных занимает короткое время и не будет стоить дорого. Вы также можете периодически обновлять цены, остатки и другие данные через свой Личный кабинет с помощью функционала быстрого обновления.
- Могут ли специалисты Enex сами подключиться к нашему API или каким-либо ссылкам / сервисам, содержащим информацию о наших товарах?
API - это программный интерфейс по которому нам присылают данные. Сам наш сервер ничего не запрашивает, а только принимает данные. Ваше API мы не реализовывали. Будем рады, если вы сможете сами пересылать данные по схеме выше. Запланируйте, пожалуйста, время своего разработчика - обычно настройка по инструкции занимает короткое время.
- Принимается ли формат XML?
Формат XML в данный момент не принимается
- Есть ли готовая обработка по обмену данными с 1С?
К сожалению, пока нет.
Коммерческие вопросы
- Какие цены нужно передавать? Что если у нас в системе нефинальные цены, например, без НДС?
Необходимо передавать финальные цены продажи с учетом всех налогов и комиссии Enex. Если в вашей системе цены нефинальные, то при передаче нужно осуществить соотвтесвующие математические приобразования.
- Мы не хотим передавать остатки, так как это конфиденциальная информация. Как быть?
Некоторые поставщики передают неточное количество на складе. Например, если 0, то передается 0; если от 1 до 4, то передается 1; если от 5 до 19, то передается 5; если более 20, то передается 20. Или если у поставщика всегда всё в наличии, то могут быть переданы средние остатки, например, всё по 20.
- У нас несколько складов. Для какого склада указывать остатки?
Если есть возможность передавать сумму остатков со всех складов, то лучше делать так. Если такой возможности нет, то передавайте остатки с главного склада.
- Как часто отправлять данные?
Обычно 1 раз в день достаточно, но вы можете отправлять данные чаще по своему усмотрению. Не следует отправлять чаще, чем раз в час.
Технические вопросы
- Есть примеры на разных языках в документации?
Описание доступных методов, примеры запросов и возможных (в зависимости от входных данных) ответов можно найти в справочнике методов API по адресу https://enex.market/api/v1/schema/swagger. Там же доступны примеры запросов через bash.
Что бы посмотреть примеры на разных языках программирования, необходимо посетить страницу https://enex.market/api/v1/schema/elements#/, зайти в любой из интересующих методов и в разделе Request Sample (чуть ниже справа) и выбрать необходимый язык программирования. В окне отобразится пример скрипта для выбранного метода и языка.
- Ошибка 401 и сообщение Wrong user type
Это означает, что пользователь использует неправильную для своей группы ссылку, например, Производитель, который пытается загружать товары по ссылке предназначенной для торговой компании (ТК).
Производитель должен использовать ссылку api/v1/products/update/manufacturer,
а ТК api/v1/products/update/trade_company
- Ошибка 404 при доступе к схеме API
Попробуйте почистить кэш.
- Ошибка 500 при запросе токена
Повторите запрос токена. При повторении ошибки обратитесь к своему менеджеру.
- Что такое limit и offset в запросе на получение данных каталога / торговых предложений?
Весь список можно выгрузить по указанной ссылке. limit - количество товаров, возвращаемых в запросе при указании 0 или значения больше 5000 (подставляется максимальное значение 5000 позиций). offset - сдвиг по списку. То есть если у вас товаров, например 9000, то вам потребуется отправить два запроса: первый вернёт первые 5000 позиций https://enex.market/api/v1/products/limit/0/offset/0, второй вернёт оставшиеся 4000 https://enex.market/api/v1/products/limit/0/offset/5000
- Можно обновлять только цены или только остатки? Что для этого передавать, нули или просто ничего не передавать?
При передачи данных в API разрешено передавать цену и остатки или только один из этих параметров. Например, для обновления только остатков можно передать поле "quantity" и не указывать поле "price"{
"article": "125111",
"quantity": 7,
}
- Через какой сервис мы можем настроить автоматическую передачу?
Postman; другие решения недоступны из России напрямую.
- Есть ли ограничение на количество передаваемой информации?
Как такого ограничения нет, но для того, чтобы запрос не падал, рекомендуется передавать не более 20 тысяч позиций за один запрос.
- Если мы будем выгружать 3000 позиций, как лучше, в теле запроса или в файле? Если в файле, где его размещать?
Доступна передача данных бинарным файлом через POST запрос. Файл вы передаёте и храните сами.
- Можем ли мы отдавать другие данные, помимо цен и остатков?
В данный момент такой функционал не предусмотрен.