API для организации обмена информацией с маркетплейсами

В этой статье мы расскажем, как взаимодействовать с API для быстрой и комфортной работы с маркетплейсами. Как настроить свой собственный отдельный метод API, приведем конкретные примеры и разберем как работают разные маркетплейсы.

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

Сегодня на российском рынке сформировалась «большая пятерка» маркетплейсов, которые определяют правила игры, а именно: Ozon, Wildberries, Яндекс Маркет, СберМегаМаркет, AliExpress. Каждая площадка предлагает продавцам собственный API для интеграции и регламент, по которому должен работать продавец. 

В статье речь пойдет об формате сотрудничества FBS — Fulfilment by Seller, при котором клиент подключает свой склад и торгует с него, отправляя товары через службу доставки маркетплейса, либо непосредственно сам доставляет заказы клиентам. 

Как работать с API маркетплейса?

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

1. Извлечь информацию о заказе из маркетплейса.
2. Загрузить полученные данные в свою учетную систему.
3. Обработать их и отправить задачу по сборке заказа на склад.
4. Отправить собранные товары в зону отгрузки.
5. Упаковать и корректно промаркировать товар в зависимости от требований маркетплейса.
6. Отгрузить товары службе доставки маркетплейса (вызвать курьерскую службу МП или самостоятельно привезти собранные заказы на склад МП).

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

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

Также просто подключить API, который предоставляет маркетплейс, не получится, для этого придется перестроить внутренние бизнес-процессы, такие как:

1. Изучение особенностей работы определенного маркетплейса.
2. Воспроизведение их в «ручном режиме» для обнаружения того, какие системы и процессы внутри бизнеса нуждаются в изменении. 
3. Привлечение разработчиков, изучение API маркетплейса и написание ТЗ по интеграции.
4. Интегрирование внутренних инфосистем с API маркетплейса и тестирование каждого процесса.

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

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

Если вы думаете, что проблема надуманная, вот вам два примера для размышлений.

Пример 1

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

У Ozon нет понятия «логистический заказ», есть понятие «отгрузка». Продавцу приходит запрос: «Вот заказ, вот его состав, нужно упаковать товары и отправить по такому-то адресу».

На AliExpress запрос включает очень много параметров, например:

1. Заказали определенный товар.
2. Заказал вот этот определенный пользователь.
3. Заказ в этот город/страну.
4. Доставка осуществляется вот этой службой.
5. За доставку взимается вот эта сумма.
6. Сделана такая-то скидка

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

На Wildberries вообще каждый товар отправляется и маркируется отдельно. Понятие заказа может различаться на каждом из маркетплейсов, и это нужно учитывать, выстраивая инфообмен с каждой площадкой.

Пример 2

Как быть, если заказ большой и все товары не умещаются в одну посылку?

Проще всего с Wildberries — этот маркетплейс не разбивает заказы, у них своя логика, при которой каждый товар оформляется отдельно.

На AliExpress для каждой посылки необходимо создать собственный логистический заказ со своим новым номером (2, 3 и так далее). Логика: одному заказу может соответствовать несколько логистических заказов.

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

API для работы в режиме в одного окна 

Просто организовать «промежуточный шлюз», который позволит продавцу отправлять запросы ко всем маркетплейсам через единое подключение — решение, лежащее на поверхности, и… не работающее. Потому что не решает главной проблемы — приведения внутренних процессов продавца в соответствие с требованиями каждого МП. 

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

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

Алгоритм решения проблемы:

1. Разработка отдельного метода API.
2. Обрабатывать каждую ошибку от конкретного маркетплейса.
3. На своей стороне выстраивать логику обработки для каждого маркетплейса отдельно.
4. При каждом изменении на любой из площадок уже на своей стороне дорабатывать детали.

Техническая часть

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

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

А что вы думаете на счет работы с маркетплейсами? Какие достоинства и недостатки вы бы выделили?