Уже более 3х лет работаем с API маркетплейсов — и вам рекомендуем
За 3 года работы в SoykaSoft ко мне нередко прилетает от коллег из других софтов вопрос, как и за счет чего же мы подгружаем данные селлеров и бухгалтеров в сервис. Наконец-то добрался до того, чтобы написать полноценную статью по этой теме и ответить на самые частые горячие вопросы. Что такое API маркетплейсов, как с этим работать и какие есть нюансы в работе - предлагаю начать с азов и постепенно переходить к секретам, которые мы каждый день используем в работе нашего сервиса внутренней аналитики.
API (от англ. application programming interface) это программный интерфейс, то есть описание способов взаимодействия одной программы с другими. Простыми словами, это набор функций, с помощью которых можно получить или передать информацию от одной программы к другой.
Большинство крупных маркетплейсов имеют специализированный API для продавцов, который направлен на автоматизацию торговой деятельности. Плюсы API интеграции очевидны:
Автоматизация. Избавление от ручного ввода данных, хранение и обработка данных непосредственно в учетной системе продавца.
Минимизация ошибок. Больше интеграции – меньше вероятности ошибки в цифрах, убираем «человеческий фактор».
Скорость. Существенная экономия времени, оперативное отслеживание изменений и ускорение принятие решений.
Защита. Использование дополнительных критериев, для исключения фатальных ошибок при работе с маркетплейсами. Например, контроль цен, или резервирование товара.
У каждой площадки свой набор возможностей для интеграции и свой регламент работы. Как правило, схема интеграции по API определяется тем, какую модель работы использует продавец на маркетплейсах. Существуют три основные модели:
FBO (fulfillment by operator). Маркетплейс на своем складе принимает и хранит товары, собирает и упаковывает заказы, доставляет их до покупателей, забирает и обрабатывает возвраты.
FBS (fulfillment by seller). Продавец хранит товары на своем складе, собирает и упаковывает заказы в пункт приема маркетплейса, далее уже маркетплейс доставляет заказы до покупателей.
DBS (delivery by seller). Продавец хранит товары на своем складе, собирает и упаковывает заказы, и самостоятельно отправляет их конечному покупателю, маркетплейс выступает в роли витрины, дополнительного канала продаж.
На данный момент крупнейшими маркетплейсами в России являются Wildberries, Ozon, Яндекс Маркет и Мегамаркет. Предлагаю для ясности рассмотреть основные возможности API по каждому маркетплейсу, начав с наиболее популярного.
Wildberries. Самый большой маркетплейс в России. Имеет самый богатый функционал по API для продавцов.
Wildberries использует все три основные модели работы: FBO, FBS и DBS. Помимо основных моделей, предоставляет API по продвижению товара (маркетинг), отзывам и чатам с покупателями, по статистике заказов и продаж, различным аналитическим отчетам и многое другое. API Wildberries сейчас активно перестраивается и расширяется. Компания Soykasoft является официальным технологическим партнером Wildberries.
Ozon. Второй в топе крупнейших маркетплейсов на российском рынке. Функционал по API также достаточно широкий и закрывает все основные потребности в автоматизации. Имеется подробная документация.
Как и на WB, используются все три основные модели работы: FBO, FBS и DBS, а также доступен разнообразный дополнительный функционал. На данный момент, Ozon имеет самый стабильный API среди ведущих маркетплейсов.
Яндекс Маркет. Замыкает тройку лидеров в списке российских маркетплейсов. Весь основной функционал для интеграции по API присутствует, имеется документация.
Реализованы все три основные модели работы с маркетплейсом. К особенностям работы с API Яндекс Маркет следует отнести реализацию двух независимых компонент «Pull» (продавец делает запросы к маркетплейсу, «классическая» схема) и «Push» (маркетплейс сам отправляет запросы продавцу). Как правило, достаточно pull-компонента.
Мегамаркет. Данный маркетплейс активно развивается, аудитория растет, обороты за последний год существенно выросли. Площадка работает по моделям FBS и DBS, модель FBO (через хранение на складе маркетплейса) не поддерживается.
К сожалению, не весь необходимый функционал работы с маркетплейсом реализован в методах API. В частности, нет получения информации о товарах, текущих остатках и ценах, не реализованы методы получения финансового отчета о продажах (отчет комиссионера).
На практике, в работе с API маркетплейсов не все так гладко, как следует из описания или из официальной документации. Рассмотрим, на что следует обращать внимание, и с какими проблемами можно столкнуться в процессе работы.
Задержки в передаче данных. Нередко возникает ситуация, когда, например, статус заказа в личном кабинете поменялся, а по API этот заказ приходит еще в «старом» статусе. Часто эта разница во времени некритична, но иногда может достигать 20-30 минут и более. Другой пример – получение остатков. Для Wildberries даже в описании метода сказано, что данные обновляются раз в 30 минут. Повлиять на эти процессы вы не можете, но следует учесть этот фактор при тестировании и разработке.
Неполные данные. Изредка возникает ситуация, когда данные по API приходят неполные, если сравнивать их с данными в личном кабинете маркетплейса, или в выгрузке в Excel. Например, такая ситуация встречалась с загрузкой документов приемки на Wildberries или финансового отчета на Яндекс Маркет. Если время позволяет, то можно создать заявку в службу технической поддержки маркетплейса с описанием проблемы (сразу прилагайте всевозможные скрины, выгрузку результата запроса, описание методов, которыми пользуетесь - чем больше информации, чем быстрее рассмотрят вашу заявку). Если же нужно «сейчас», то корректируйте данные вручную, или попробуйте загрузить данные альтернативными способами.
Отсутствие данных. Также время от времени может возникнуть ситуация, когда данные просто не приходят (пустой запрос), или запрос возвращает ошибку (коды ошибок могут быть при этом разные, как правило, это 401, 403, 500). Чаще всего это связано с пиковой нагрузкой на серверы маркетплейсов, и самый простой способ решения – просто подождать. Рекомендуем следить за сообщениями в официальных технических каналах маркетплейсов и в неофициальных чатах разработчиков, где сообщается информация о плановых технических работах или сбоях в работе серверов.
Ограничения в запросах. На многие запросы по API существует ряд ограничений для уменьшения нагрузки на серверы маркетплейсов. Это может быть лимит запросов - максимальное количество запросов одного вида за интервал времени. Или лимит данных - максимальное количество возвращаемых данных в запросе. Существуют ограничения на максимальный диапазон дат за один запрос, или максимальное число передаваемых параметров в запросе.
Читайте внимательно документацию, чтобы выявить и учесть эти ограничение при проектировании схемы обмена данными по API. Вызывайте последовательно несколько запросов, предусмотрите паузу между запроса при превышении лимита запросов (как правило, это ошибка с кодом 429). Используйте пагинацию для получения данных постранично. Проверяйте передаваемые значения в запрос на превышение максимально допустимых значений.
Изменения в API. API маркетплейсов динамично развивается, добавляется новый функционал и новые возможности, при этом некоторые ранее используемые методы устаревают и исключаются из API. Информации об изменениях на маркетплейсах приходит довольно много и сложно отследить ключевые для вас события. Но это необходимо делать, чтобы обмен по API продолжал стабильно работать. Отслеживайте изменения по API в официальных каналах маркетплейсов, следите за изменениями в документации. Составьте список методов, которые вы используете в своей работе и время от времени проверяйте по ним изменения.
Несмотря на ряд сложностей и существующих проблем при работе с API, данный инструмент является незаменимым помощником для продавцов и позволяет автоматизировать торговую деятельность на маркетплейсах. Не бойтесь обращаться к нему в своей работе, пробовать интересные сочетания инструментов и тестировать новые гипотезы, ведь именно так и находится истина.