Интеграция Goods.ru с магазинами petfood.ru и oblako-msk.ru
Автоматическое получение заказов из маркетплейса Goods.ru через API. Передача товарных предложений, синхронизация статусов, обработка заказов в админке магазина.
Что такое 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:
- Зарегистрируйтесь на goods.ru/partners
- Заполните анкету продавца
- Пройдите модерацию
- Получите доступ к личному кабинету
- Сгенерируйте API-ключи
- Настройте интеграцию
Результат
- Заказы из Goods.ru автоматически попадают в админку магазина
- Менеджеры работают в одном интерфейсе
- Статусы синхронизируются в обе стороны
- Товарный фид обновляется автоматически
- Актуальные остатки и цены на маркетплейсе
- Нет необходимости вручную переносить заказы
- Экономия времени менеджеров
О проектах
petfood.ru — интернет-магазин зоотоваров. Корма, аксессуары, игрушки для животных.
oblako-msk.ru — магазин электроники и бытовой техники.