Интеграция с маркетплейсом

Автоматическое получение заказов из маркетплейса Goods.ru через API. Передача товарных предложений, синхронизация статусов, обработка заказов в админке магазина.

Краткая информация

  • Проекты petfood.ru, oblako-msk.ru
  • Маркетплейс Goods.ru
  • Модель CPS (Cost-per-Sale)
  • Интеграция REST API
Интеграция Goods.ru Личный кабинет продавца

Источник: varlamov.ru

Что такое Goods.ru

Goods.ru — российский маркетплейс для товаров из разных категорий. Работает по модели CPS (Cost-per-Sale): продавец платит комиссию только за выполненный заказ.

В отличие от других маркетплейсов, где нужно платить за размещение или за клики, здесь оплата только за реальные продажи.

Задача

Магазины petfood.ru и oblako-msk.ru начали продавать товары на Goods.ru. Проблема: заказы приходили в личный кабинет маркетплейса, менеджеры работали в двух интерфейсах.

Нужно было сделать так, чтобы заказы из Goods.ru автоматически попадали в админку магазина. Менеджеры обрабатывают все заказы в одном месте.

Что реализовали

Получение заказов

Настроили автоматическое получение заказов из Goods.ru через API. Каждый новый заказ создается в админке магазина со всеми данными:

  • Номер и дата заказа из Goods.ru
  • Время доставки, трек-код отслеживания
  • Способ оплаты (наличные, карта, онлайн)
  • Состав заказа с идентификаторами товаров
  • Комментарии покупателя
  • Адрес и контактные данные

Синхронизация статусов

Настроили двустороннюю синхронизацию статусов заказов. Когда менеджер меняет статус в админке магазина, он автоматически обновляется в Goods.ru.

Статусы:

  • Новый — заказ только что создан
  • В обработке — менеджер подтвердил заказ
  • Отправлен — товар передан в доставку
  • Доставлен — покупатель получил заказ
  • Отменен — заказ отменили (по разным причинам)

Выгрузка товарного фида

Настроили автоматическую выгрузку товаров из магазина в Goods.ru. Фид обновляется раз в несколько часов (настраивается).

В фид передаются:

  • Название товара
  • Описание
  • Фотографии
  • Цена и старая цена (для акций)
  • Остатки на складе
  • Характеристики (вес, размер, цвет и т.д.)
  • Артикул и штрихкод

Зачем регулярное обновление

Когда товар заканчивается на складе или меняется цена, информация на маркетплейсе должна обновиться. Автоматическая выгрузка фида каждые 2-4 часа гарантирует актуальные данные.

Технические детали

API Goods.ru

Goods.ru предоставляет REST API для продавцов. Через API можно:

  • Получать список заказов
  • Обновлять статусы заказов
  • Загружать товарный фид (XML или JSON)
  • Получать статистику продаж

Авторизация

Для работы с API нужны ключи доступа из личного кабинета продавца Goods.ru. Ключи используются для авторизации каждого запроса.

Webhook для заказов

Настроили webhook — когда на маркетплейсе создается новый заказ, Goods.ru отправляет уведомление на сервер магазина. Сервер обрабатывает данные и создает заказ в админке.

Это быстрее, чем постоянно опрашивать API на предмет новых заказов.

Формат товарного фида

Goods.ru принимает фид в формате YML (Yandex Market Language). Это XML-файл с описанием товаров.

Пример структуры:

<offer id="12345">
  <name>Корм для собак Royal Canin 15кг</name>
  <price>4500</price>
  <oldprice>5000</oldprice>
  <currencyId>RUR</currencyId>
  <categoryId>100</categoryId>
  <picture>https://example.com/image.jpg</picture>
  <delivery>true</delivery>
  <available>true</available>
</offer>

Сопоставление товаров

Когда приходит заказ с маркетплейса, в нем указаны ID товаров из Goods.ru. Система сопоставляет эти ID с товарами в магазине по артикулу или SKU.

Если товар не найден — создается предупреждение для менеджера.

Схема CPS (Cost-per-Sale)

CPS — модель оплаты, где продавец платит только за выполненный заказ. Нет абонентской платы, платы за размещение или за клики.

Goods.ru берет процент от стоимости заказа. Размер комиссии зависит от категории товара и договора с маркетплейсом.

Подключение к Goods.ru

Чтобы начать продавать на Goods.ru:

  1. Зарегистрируйтесь на goods.ru/partners
  2. Заполните анкету продавца
  3. Пройдите модерацию
  4. Получите доступ к личному кабинету
  5. Сгенерируйте API-ключи
  6. Настройте интеграцию

Результат

  • Заказы из Goods.ru автоматически попадают в админку магазина
  • Менеджеры работают в одном интерфейсе
  • Статусы синхронизируются в обе стороны
  • Товарный фид обновляется автоматически
  • Актуальные остатки и цены на маркетплейсе
  • Нет необходимости вручную переносить заказы
  • Экономия времени менеджеров

О проектах

petfood.ru — интернет-магазин зоотоваров. Корма, аксессуары, игрушки для животных.

oblako-msk.ru — магазин электроники и бытовой техники.

Технологии

Goods.ru Маркетплейс API интеграция Webhook YML Синхронизация заказов E-commerce CPS